HTML5空格提交规范详解

Git提交信息本质是纯文本而非HTML，必须严格使用ASCII空格（U+0020）和换行符，禁用所有HTML实体（如 、 ）及Unicode非标准空格（如\u3000、\u2005），否则不仅无法渲染生效，反而会以原始字符形式污染日志、破坏CI工具解析、导致grep匹配失败或git log显示异常；日常协作中最常见的问题源于从网页、微信、Word等富文本环境复制粘贴时意外引入隐形字符，因此务必启用编辑器“显示不可见字符”、用cat -A检查，并在husky或CI中加入自动化校验拦截HTML实体与行尾空白——真正干净有力的提交信息，永远只依赖最朴素的空格与换行。

Git 提交信息里不需要、也不应该用 HTML5 空格（比如  、  等）——它们不是文本空格，提交信息是纯 ASCII/UTF-8 文本，HTML 实体在 Git 日志中只会原样显示为字符序列，毫无意义，还可能破坏自动化工具解析。

Git 提交信息本质是纯文本，不是 HTML

Git 的 git commit -m 或编辑器中输入的内容，最终存为 UTF-8 编码的普通文件（.git/COMMIT_EDITMSG），没有 HTML 解析器。写入   就真的只是 6 个字母加符号： ，不会变成不可见空格或渲染效果。

• 所有  、 、  等 HTML 实体，在 Git 中都只是普通字符串，不被解释
• 终端、git log、GitHub/GitLab 提交页、CI 工具（如 GitHub Actions 的 GITHUB_HEAD_REF 上下文）均按字面显示，不转义
• 某些编辑器（如 VS Code）在提交时若启用了“自动转换全角空格”或“富文本粘贴”，反而可能混入 \u3000（中文空格）等非标准空白符，导致脚本解析失败

真正该用的空格：ASCII SP（U+0020）和换行

Git 提交信息规范（遵循 Conventional Commits 或 Angular 风格）只依赖标准空白字符：

• 标题行（subject）用单个 ASCII 空格分隔 type/scope，如：feat(user): add login timeout
• 正文与标题之间必须空一行（即两个 \n）
• 避免行首/行尾空格；避免制表符 \t；避免 Unicode 四分之一空格（\u2005）、图形容器空格（\u3000）等
• 如果需对齐（如表格式 CHANGELOG），用空格手动对齐即可，别用   —— 它在这里既不生效，又污染可读性

容易踩的坑：复制粘贴带格式文本引入隐形字符

从网页、Notion、微信、Word 复制文字到 Git 提交信息，极易带入以下问题：

•   被粘贴成字面量  ，出现在日志里非常突兀
• 中文输入法下误按「全角空格」键，插入 \u3000，git log --oneline 可能截断异常，CI 中 grep "fix" 匹配失败
• Markdown 预览器渲染后复制，把 **bold** 带进提交信息，Git 不识别加粗语法
• 解决方法：粘贴后用 cat -A 检查（显示 M-BM- 表示 \u3000），或在编辑器启用“显示不可见字符”

自动化校验建议（防患于未然）

可在 .husky/pre-commit 或 CI 脚本中加入轻量检查：

if git diff --cached --quiet; then exit 0; fi
git diff --cached --name-only | xargs -I{} sh -c 'git show :{} | grep -q "[[:space:]]$" && echo "ERROR: trailing whitespace in $(basename {})" && exit 1' 2>/dev/null || true
git status --porcelain | awk '{print $2}' | xargs -I{} sh -c 'git show :{} | grep -q "&[a-z]*;" && echo "ERROR: HTML entity in $(basename {})" && exit 1' 2>/dev/null || true

重点拦截两类：行尾空白、含 &xxx; 的字符串 —— 这些几乎肯定是误粘贴。

真正的空格问题，从来不在“怎么用 HTML5 空格”，而在于“怎么确保只用最朴素的 和 \n”。复杂编码、富文本、渲染意图，全部交给 README 或 PR 描述，别塞进 Git 提交信息里。

以上就是《HTML5空格提交规范详解》的详细内容，更多关于的资料请关注golang学习网公众号！