747 B
747 B
inclusion
| inclusion |
|---|
| always |
语言与编码规范(强制)
输出语言
- 默认:所有“说明性文字”一律使用简体中文(对话回复、文档内容、代码注释、README/ADR/变更说明等)。
- 允许保留英文的部分:
- 代码标识符(类名/函数名/变量名/接口名/库名/命令名)不翻译
- 第三方工具的原始 CLI 输出/报错原文不篡改(可在原文后补充中文解释)
文档与注释
- 新增/修改的文档必须与代码变更同步更新
- 注释只写“为什么/边界/假设”,避免复述代码
编码与字符集
- 仓库内所有文本文件统一 UTF-8(建议无 BOM)
- 禁止出现 GBK/Big5 混用;若发现历史文件,先转码再重构