例如,我有一个名为 Purchase Service 的 RESTful 服务。我应该命名我的存储库:
purchaserestservice
purchase-rest-service
purchase_rest_service
- 或者是其他东西?
什么是约定?在 Github 上怎么样?公共存储库应该遵循某种标准吗?
例如,我有一个名为 Purchase Service 的 RESTful 服务。我应该命名我的存储库:
purchaserestservice
purchase-rest-service
purchase_rest_service
什么是约定?在 Github 上怎么样?公共存储库应该遵循某种标准吗?
我会去purchase-rest-service
。原因:
什么是“购买休息服务”?长而连在一起的词很难理解。我知道,我是德国人。“Donaudampfschifffahrtskapitänspatentausfüllungsassistentenausschreibungsstellenbewerbung。”
“_”比“-”更难输入
Camel case 的问题在于,通常对单词有不同的解释——例如,checkinService 与 checkInService。根据 Aaron 的回答,如果您有许多类似名称的存储库必须不断检查创建您关心的存储库的人是否使用了大写和小写的某种细分,那么自动完成是很困难的。避免大写。
他关于破折号的观点也是明智的。
lowercase-with-hyphens
是我在 GitHub 上最常看到的风格。*
lowercase_with_underscores
可能是我看到的第二受欢迎的风格。
前者是我的首选,因为它可以节省击键。
*轶事;我没有收集任何数据。
在不偏爱任何特定命名选择的情况下,请记住 git repo 可以克隆到您选择的任何根目录中:
git clone https://github.com/user/repo.git myDir
这里repo.git
将被克隆到myDir
目录中。
因此,即使您对公共 repo 的命名约定最终有点不正确,仍然可以在客户端对其进行修复。
这就是为什么在任何客户端都可以为所欲为的分布式环境中,Git 存储库没有真正的命名约定。
(除了为repo '' 的裸形式保留“ xxx.git
” )
可能存在 REST 服务的命名约定(类似于“ Are there any Naming Convention Guidelines for REST APIs? ”),但这是一个单独的问题。xxx
也许这只是我的 Java 和 C 背景显示,但我更喜欢 CamelCase (CapCase) 而不是名称中的标点符号。我的工作组使用这样的名称,可能是为了匹配存储库包含的应用程序或服务的名称。