编码与防乱码规范
本项目统一采用以下规则,避免中文乱码和编码冲突:
必须遵守
- 新建文件统一使用
UTF-8 编码,且不带 BOM
- 修改已有文件前先检查原文件编码
- 如果旧文件不是
UTF-8,默认先保持原编码,避免把中文写坏
- 中文内容直接保留,不要转义成
\uXXXX
- 输出、生成、批量替换时不得出现乱码
- 如果终端显示异常,先校验文件真实字节和编码,再继续修改
推荐做法
- 优先遵循项目根目录
.editorconfig
- 对包含大量中文注释、字符串的文件,优先小范围修改
- 批量替换前先做编码抽样检查,再执行批量修改
- 每次涉及中文内容的批量改动后,及时编译或检查 diff
项目内对应位置
- 编辑器默认规则:
/.editorconfig
- AI 与协作约束:
/AGENTS.md