问题描述

以下 Markdown 文件使用 UTF-8 with BOM 编码（文件开头带 EF BB BF 三个字节），不符合 CANN《文档写作规范》对文件编码的要求：

该文件位于仓库根目录，是版本变更记录的入口文档。

规范依据

CANN 社区《文档写作规范》「文件编码格式要求」一节明确规定：

【规则】markdown文件需要使用UTF-8编码格式……不可使用UTF-8 with BOM的编码格式，此格式会在文件开头添加3个冗余字符：EF BB BF，可能会造成不同平台上的显示异常问题。

影响分析

1. 首行渲染异常：BOM 会被拼接在首个字符之前，一级标题实际为 \uFEFF# …，部分渲染器与静态站点生成器不会吞掉该不可见字符，导致标题无法被正确识别；
2. 工具链兼容性：按 ^# 匹配标题、按首行内容做处理的脚本会漏掉或错判这些文件；
3. 与仓库内其他文档不一致：同仓其他 Markdown 文件均为无 BOM 的标准 UTF-8，仅个别文件带 BOM，属个别遗漏。

修复建议

移除文件开头的 3 字节 BOM（EF BB BF），其余内容字节零改动。修改后可用如下命令复核：

head -c 3 <file> | xxd   # 输出不应以 efbb bf 开头

问题复现方式

git clone --depth 1 https://gitcode.com/cann/asc-comm.git
cd asc-comm

head -c 3 CHANGELOG.md | xxd | head -1   # efbb bf 即 BOM

影响级别

L1：文件编码格式类问题，为规范中的明确禁止项；不影响内容正确性。