Gitee开源指北1。0开源项目必须用英文命名标识符吗？

　　编者按
　　此部分在整个《开源指北1。0》文档中，仅占了极小一部分，但其意义不言而喻。
　　初稿起草于2020年10月末，之后颇有波折，包括一次长达一周的pr讨论。很高兴看到此部分在正式发布的此版文档中保留。特此感谢Gitee开源社区与官方的理性与包容。
　　期间也认识到，开源社区仍有相当对非英文母语命名标识符的误会。还请各位多多对此部分完善补充，特别是相关实践的现身说法与所见所闻。也请各位多多关注与此部分相关的pr，时刻准备着与各种误解作切磋交流。正文
　　虽然很多开发者早已知道多数常用编程语言支持中文命名标识符并付诸实践，但仍然常见如果项目开源的话还是要用英文命名的说法。2007年Python3决定支持非ASCII码标识符的增强建议书中指出：
　　Adeveloperwishingtomakealibrarywidelyavailableneedstomakeanumberofexplicitchoices（suchaspublication，licensing，languageofdocumentation，andlanguageofidentifiers）。Itshouldalwaysbethechoiceoftheauthortomakethesedecisionsnotthechoiceofthelanguagedesigners。
　　希望使库广泛可用的开发人员需要做出许多抉择（例如发布、许可、用何种语言编写文档和命名标识符）。决定权都应在项目作者而不是语言设计者手中。
　　这段话同样适用于开源项目。无论是文档还是源码中标识符使用的语言，项目作者都可以根据实际需求来灵活决定，而非简单的一刀切用英文。实际上，开源项目往往是在开发者业余的碎片时间进行，文档和测试往往从简。这种情况下，代码的清晰度和可维护性对于项目可持续性尤显重要，这恰恰是母语命名标识符的优势。正如同一文档指出：
　　Byusingidentifiersintheirnativelanguage，codeclarityandmaintainabilityofthecodeamongspeakersofthatlanguageimproves。
　　通过使用母语命名的标识符，代码的清晰度和可维护性对于该母语使用群体得到了提高。
　　下面是一些常见的疑虑：用中文命名出了问题怎么办？
　　像任何技术一样，在使用推广中必然有各种问题出现。如果是编程语言或是开源框架对中文命名的支持问题，可以向它们的开发组反映，往往能得到解决，先例有Vue。js、Hibernate、pip等等。另外，也可在开源中国社区求助，协力解决。毕竟，鲁迅先生说过：走的人多了，也便成了路。
　　框架限制必须用英文怎么办？
　　比如JavaBeans规范通常要求使用setget前缀。即便如此，仍然可以使用中英混合的命名，只要开发者感觉更易读即可，比如getCostOutcomeRatioByClientGroup相比get投入产出比By客户组。类似地，一些常用的英文术语或简写，如果没想到合适中文对应术语，大可以暂时保留这部分英文命名。
　　中英文混输的效率会低吗？
　　大多数情况下，读代码的时间远超过写代码的时间。即便仅仅讨论写代码的效率，也要考虑推敲英文命名甚至查字典的时间，何况很多领域业务相关命名连恰当英文表达都很难找到。另外，随着中文命名实践的普及，相应的IDE辅助功能也在不断涌现，比如JetBrains和VSCode的中文代码补全插件。
　　用拼音效果一样吗？
　　从代码可读性看，使用拼音不如中文。比如shipin，就有食品视频饰品等等理解。即便可以根据代码上下文进行猜测，无疑也是额外的负担。拼音缩写的可读性更差，像xmjl，到底是姓名记录、项目奖励、项目监理还是项目经理呢？如果需要额外中文注释才能避免误解，还不如将直接将中文注释的内容用于命名。输入效率来说，输入全部拼音的速度也往往不如输入中文，因为大多数中文词语不需输入全部拼音即可选词。更不用说用拼音命名更容易出现细节错误如翘平舌、前后鼻音等等。
　　项目已经是英文命名的，没法转了？
　　如果某一部分的英文命名经常在开发组中引起误解或者新手甚至自己也难以看懂，可以尝试从这部分先开始中文化，看看效果后再逐步在其他部分采用。与任何未曾尝试过的技术一样，渐进增量式的应用可以减小风险、在使用中逐渐适应。
　　用了中文命名之后，怎样为国外用户服务？
　　如果需要面向国外用户，首先要对用户界面和使用文档进行国际化。如果是库，用户界面就是API。技术上，可以开发中英两套API。如果想更进一步，鼓励国外开发者参与开发项目，当然可以逐步将命名英文化，但也应综合考虑是否值得。
　　总之，澄清这个误区的目的，绝不是排斥英文命名，而是让更多开源作者意识到可以视项目性质和自身情况因地制宜、具体情况具体分析，灵活选择何时、何处进行中文命名实践，也希望中文开源社区能以开放宽容的心态看待中文命名标识符这一并不新的新技术。