软件开发实现与文档编写是否应几乎全程使用英文？

开发者阿泽

2026-6-1

软件开发中命名与注释的语言选择讨论与经验分享

讨论背景

在Software Engineering SE上曾发起一场讨论：软件开发中命名与注释是否应始终使用英文？

本地团队场景的反对声音：部分用户认为，如果项目由本地团队开发且仅面向本地用户，使用英文没有实际益处；反而非母语开发者的英文表述可能存在缺陷，导致命名或注释模糊、误导，形成劣势。
坚决反对非英文的立场：根据个人经验，使用英文以外的语言是相对严重的错误，后续会引发诸多麻烦，核心原因有两点：
1. 全球一体化加深，新团队成员可能来自其他国家，英文是计算机领域的通用语言（lingua franca），是跨地域协作的基础。
2. 软件生命周期往往超出预期，后续可能会进入国际化场景，或由不同团队维护，非英文的代码和文档会成为协作障碍。

人员流动后的协作低效：曾参与全中文命名的内部OA系统，后来团队加入外籍实习生，他们只能靠翻译工具逐行解析dingDanChuLiQi、caiGouShenQingBiao这类变量名，不仅效率极低，还因翻译歧义导致过3次线上bug。
项目拓展的额外成本：有个本地餐饮项目初期用日文写注释，后来要拓展到中国市场，对接国内支付接口时，外包团队完全看不懂原有注释，不得不花两周重新梳理代码逻辑，直接延误了上线计划。
开发工具的适配问题：早年参与的一个用中文变量名的C++项目，在老版本编译器中频繁出现乱码和编译错误，排查耗时近一周才定位到是字符编码兼容问题。
知识复用的局限性：非英文的代码和文档无法被全球开发者社区检索，项目遇到疑难问题时，很难在技术社区找到参考方案，只能靠团队内部反复试错。

统一使用英文作为技术语言：无论当前团队是否本地化，都建议用英文做命名、注释和技术文档，这是行业通用标准，能从根源上避免后续协作和拓展的风险。
业务术语可保留本地化标识但需补英文注释：如果有特定本地业务术语（如方言称谓），可以在变量名中保留拼音或原词，但必须在注释里补充英文解释，比如：
```
// heshou: Local term referring to the staff responsible for contract verification
std::string heshou_id;
```
制定规范并落地执行：团队要明确代码语言规范，比如变量名用驼峰式英文、注释用完整英文句子，通过代码审查、自动化检测等方式确保规范被严格执行。
非母语开发者的英文提升方案：借助词典、语法工具辅助英文表述，团队内部可组织英文技术文档共读、代码注释互评活动，短期的学习成本远低于非英文带来的长期风险。

内容的提问来源于stack exchange，提问作者Peter - Reinstate Monica