Git提交信息必须使用纯ASCII/UTF-8文本,禁用HTML实体(如 )和非标准空格(如\u3000),仅允许ASCII空格(U+0020)和换行符,以确保工具链兼容与解析可靠。
Git 提交信息里不需要、也不应该用 HTML5 空格(比如 、 等)——它们不是文本空格,提交信息是纯 ASCII/UTF-8 文本,HTML 实体在 Git 日志中只会原样显示为字符序列,毫无意义,还可能破坏自动化工具解析。
Git 的 git commit -m 或编辑器中输入的内容,最终存为 UTF-8 编码的普通文件(.git/COMMIT_EDITMSG),没有 HTML 解析器。写入 就真的只是 6 个字母加符号: ,不会变成不可见空格或渲染效果。
、 、 等 HTML 实体,在 Git 中都只是普通字符串,不被解释git log、GitHub/GitLab 提交页、CI 工具(如 GitHub Actions 的 GITHUB_HEAD_REF 上下文)均按字面显示,不转义\u3000(中文空格)等非标准空白符,导致脚本解析失败Git 提交信息规范(遵循 Conventional Commits 或 Angular 风格)只依赖标准空白字符:
feat(user): add login timeout
\n)\t;避免 Unicode 四分之一空格(\u2005)、图形容器空格(\u3000)等 —— 它在这里既不生效,又污染可读性从网页、Notion、微信、Word 复制文字到 Git 提交信息,极易带入以下问题:
被粘贴成字面量 ,出现在日志里非常突兀\u3000,git log --oneline 可能截断异常,CI 中 grep "fix" 匹配失败**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 提交信息里。