# 编码与防乱码规范

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

## 必须遵守

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

## 推荐做法

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

## 项目内对应位置

- 编辑器默认规则：`/.editorconfig`
- AI 与协作约束：`/AGENTS.md`