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

编码与中文处理规则

本项目后续所有代码修改必须遵守以下规则:

  1. 新建文件统一使用 UTF-8 编码,且不带 BOM
  2. 修改已有文件前,先检查原文件编码;如果不是 UTF-8,默认先保持原编码,避免把中文写坏。
  3. 中文内容必须直接保留,不允许转义成 \\uXXXX
  4. 输出、提交、生成代码时不得出现乱码;如果终端显示异常,必须先校验文件真实字节编码,再继续修改。
  5. 涉及批量替换时,只能在确认编码安全后执行;不能为了批量迁移把中文内容改坏。

推荐做法:

  • 优先依赖项目根目录 .editorconfig
  • 修改前先确认文件编码,再选择对应的写回方式。
  • 对包含大量中文注释、字符串的文件,优先小范围修改并及时编译验证。