编辑 | blame | 历史 | 原始文档

编码与防乱码规范

本项目统一采用以下规则,避免中文乱码和编码冲突:

必须遵守

  1. 新建文件统一使用 UTF-8 编码,且不带 BOM
  2. 修改已有文件前先检查原文件编码
  3. 如果旧文件不是 UTF-8,默认先保持原编码,避免把中文写坏
  4. 中文内容直接保留,不要转义成 \uXXXX
  5. 输出、生成、批量替换时不得出现乱码
  6. 如果终端显示异常,先校验文件真实字节和编码,再继续修改

推荐做法

  • 优先遵循项目根目录 .editorconfig
  • 对包含大量中文注释、字符串的文件,优先小范围修改
  • 批量替换前先做编码抽样检查,再执行批量修改
  • 每次涉及中文内容的批量改动后,及时编译或检查 diff

项目内对应位置

  • 编辑器默认规则:/.editorconfig
  • AI 与协作约束:/AGENTS.md