编码与中文处理规则
本项目后续所有代码修改必须遵守以下规则:
- 新建文件统一使用
UTF-8 编码,且不带 BOM。
- 修改已有文件前,先检查原文件编码;如果不是
UTF-8,默认先保持原编码,避免把中文写坏。
- 中文内容必须直接保留,不允许转义成
\\uXXXX。
- 输出、提交、生成代码时不得出现乱码;如果终端显示异常,必须先校验文件真实字节编码,再继续修改。
- 涉及批量替换时,只能在确认编码安全后执行;不能为了批量迁移把中文内容改坏。
推荐做法:
- 优先依赖项目根目录
.editorconfig。
- 修改前先确认文件编码,再选择对应的写回方式。
- 对包含大量中文注释、字符串的文件,优先小范围修改并及时编译验证。