如果您拥有一个API,并且您是一名总受众面高度国际化的英国开发人员,那么您的API应该被
setColour()
或。setColor()
(以一个简单的单词为例。)
总体上,英国工程师对他们的“正确”拼写方式往往持守防御态度,但可以说美式拼写在国际市场上更具有“标准性”。问题在于这是否重要?其他地区的开发人员是否难以理解英式拼写,还是通常很明显事物的含义?
应该全部使用美式英语吗?
如果您拥有一个API,并且您是一名总受众面高度国际化的英国开发人员,那么您的API应该被
setColour()
或。setColor()
(以一个简单的单词为例。)
总体上,英国工程师对他们的“正确”拼写方式往往持守防御态度,但可以说美式拼写在国际市场上更具有“标准性”。问题在于这是否重要?其他地区的开发人员是否难以理解英式拼写,还是通常很明显事物的含义?
应该全部使用美式英语吗?
大部分开发文档(就像MSDN一样)都是用美式英语编写的。
因此,如果您的目标受众是国际化的,最好跟随主流并在API中使用美式英语。
我会尽可能寻找替代词。我可以使用色调、墨水、前/背景来代替 "Color" ...
如果不行,作为一个英国人,我会使用 en-GB,因为我还有一些对我的国家和起源的自豪感。
但如果它是一个更大的项目,特别是一个国际性的项目,我会保持整个项目的一致性,而不是让一个小部分用一种语言,其他部分用另一种语言。
明确是美式英语。
首先,我在美国。 在我的当前项目中,它总是“color”,但是我们无法确定拼写的单词是“grey” 还是 “gray”。
这实际上变得非常烦人。
我是那种每次被迫在设置文件等中使用美式英语时,心率和血压都会上升的人,因为软件没有提供英式英语选项,但这只是我的个人看法 :)
然而,我的个人意见是提供两种拼写方式,即setColor()和setColour(),在其中一种中编写代码,并使第二种通过参数传递。
这样,您可以让两个群体都感到满意,尽管您的智能提示会变得有点长,但至少人们不能抱怨您使用了“错误”的语言。
我建议看看你所使用语言的其他库是如何选择和遵循它们的惯例的。
编程语言及其内置API的设计者做出了选择,无论用户是否国际化,他们都习惯于看到与此选择一致的拼写。你的目标不是针对不同语言的说话者,而是针对编程语言的用户。很可能他们已经从内置API中学会了许多外语单词,并且可能不知道美式英语和英式英语之间的差异。不要通过改变用词方式来混淆他们。
我主要使用.NET语言,.NET Framework使用美式英语拼写。在这个平台上,我会坚持使用美式英语。我不知道有哪些语言标准化了英式英语,但如果你的语言确实这样做了,那么请保持语言的一致性。
我同意“选择美式英语”的观点。在写电子邮件等方面,我个人更喜欢使用en-GB,但在所有编程领域中,美式英语几乎是标准。