Git提交信息必须使用纯ASCII/UTF-8文本,禁用HTML实体(如 )和非标准空格(如\u3000),仅允许ASCII空格(U+0020)和换行符,以确保工具链兼容与解析可靠。

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 提交信息里。











