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