技术写作标点与排版规范提示

在技术文档中，严谨的排版不仅是为了美观，更是为了提升信息传递的效率和准确性。

空格：排版的「呼吸感」

中西文之间的「盘古之白」

中日韩CJK表意文字与西文字母、数字之间，建议保留约 1/4 字宽的间距。

• LaTeX／排版引擎：如 XeLaTeX 或 Typst，会自动处理这类间距，无需手动加空格。
• Web 排版（Markdown/HTML）：目前 CSS 属性 text-autospace（属于 CSS Text Module Level 4）已在主流浏览器（如 Chrome、Edge、Safari）中得到支持，可通过设置 text-autospace: normal; 实现自动间距。尽管浏览器已具备此能力，但由于多数网站（及 Markdown 渲染器）尚未默认启用该属性，且为了保证源码在各种编辑器下的可读性，目前仍建议手动插入一个空格。

原则：即便手动空格不完全等于 1/4 字宽，但在视觉上，使用 Python 开发 远比 使用Python开发 易读。

西文标点与其后的空格

在处理英文或代码注释时，请务必遵守「点号后置空格」原则：

• 点号（, . : ; ! ?）：符号前不留空格，符号后必须有一个空格。
• 括号与引号：空间加在「外侧」。例如：运行 (Run) 按钮 或 他说：“你好。”（注：中文全角标点自带空间，通常不额外加空格）。

数字与单位的精密匹配

技术写作中，数字与单位的关系有着严格的国际标准（SI 规范）。

必须加空格的情况

绝大多数物理单位在作为符号使用时，前面必须加空格^[1]：

• 5 kg
• 10 km
• 20 ℃

不加空格的情况

• 百分比：30%
• 角度度数：45°

专业方案：LaTeX 中的 siunitx

手动管理空格既累又易错，推荐使用 siunitx 宏包：

\qty{10}{\kilo\meter}  % 自动处理间距与字体
\qty{20}{\celsius}     % 自动生成 20 °C

引号：从打字机时代进化

拒绝直引号

直引号（' 和 "）是打字机时代的产物。在现代出版级文档中，应使用成对的弯引号。

符号	编码	含义
'	U+0027	撇号
"	U+0022	引号
‘	U+2018	左单引号
’	U+2019	右单引号
“	U+201C	左双引号
”	U+201D	右双引号

语言环境的影响

中英文引号在 Unicode 中共用码位，但字形Glyph取决于语言声明。

• 中文环境：引号通常全角化，居中或偏向一侧（如“引号”）。
• 英文环境：引号通常紧凑且具有明显的倾斜弧度（如 “quotes”）。

Web 开发提示：务必在 HTML 根元素或容器上设置正确的 lang 属性，否则浏览器可能调用错误的字体映射。

中文语境下，也可以使用全宽的直角引号 「」 对齐文字和视觉效果。

进阶：连字符与连接号

这是许多技术作者容易忽略的细节。在英文技术文档中，-、– 和 — 的含义截然不同：

• Hyphen（连字符 -）：用于连接复合词，如 cross-platform。
• En Dash（短破折号 –）：表示范围，如 10–20 kg。
• Em Dash（长破折号 —）：用于解释说明或语气转向，前后不加空格。

LaTeX 中的特殊处理

LaTeX 有其独特的语法来处理这些符号，避免排版引擎误解：

• 引号：使用反引号（键盘 Tab 键上方）开启。
  • 单引号：`phrase'
  • 双引号：``phrase''
• 破折号：
  • -- 生成 En Dash (–)
  • --- 生成 Em Dash (—)
• 防止换行：在数字与单位之间使用波浪号 ~（如 10~kg），可以防止单位被意外挤到下一行开头。

---

优秀的排版是透明的——读者不应注意到标点，而应无阻碍地吸收知识。如果你能坚持在中日韩表意文字和西文字符间加个空格，你就已经超过了 80% 的中文技术作者。

1. Writing with SI (Metric System) Units https://www.nist.gov/pml/owm/writing-si-metric-system-units ↩