［译］Maven项目groupId、artifactId和version命名规范

逃离我推掉我的手 2021-10-23 21:58 525阅读 0赞

**groupId** 是（Maven）项目的唯一标识。Group ID必须满足 [Java包名规范][Java] ，这意味着是形如：`org.apache.maven`，`org.apache.commons`的格式。Maven不强制此规范，很多遗留的旧项目使用单个单词作为group ID。但是，很难用单个单词作为（新项目的）group ID，并将其提交到Maven中央仓库中。

你可以创建任意数量的子分组。一种比较好的来划分`groupId`的颗粒度的方式是使用项目结构（package structure）。这是指，如果当前项目是一个多模块（module）的项目，可以通过在父`groupId`的基础上增加后缀的形式来定义，例如：  
`org.apache.maven`，  
`org.apache.maven.plugins`，  
`org.apache.maven.reporting`

**artifactId** 是不带版本号的jar的名字，唯一要求是使用小写字母，且没有特殊符号。如果这是一个第三方的jar包，必须使用其被发布的包名，例如：`maven`，`commons-math`

**version** 如果要发布，可以选择典型的数字和点号组成的版本号（`1.0`，`1.1`，`1.0.1`…）不要使用日期，因为它们通常和SNAPSHOT版本号联系在一起。如果是一个第三方的artifact，你必须使用它提供的版本号，无论这些版本号看起来多么奇怪，比如：`2.0`，`2.0.1`，`1.3.1`

原文链接：[Guide to naming conventions on groupId, artifactId, and version][Guide to naming conventions on groupId_ artifactId_ and version]

[Java]: https://links.jianshu.com/go?to=https%3A%2F%2Fdocs.oracle.com%2Fjavase%2Fspecs%2Fjls%2Fse6%2Fhtml%2Fpackages.html%237.7
[Guide to naming conventions on groupId_ artifactId_ and version]: https://links.jianshu.com/go?to=%255Bhttps%3A%2F%2Fmaven.apache.org%2Fguides%2Fmini%2Fguide-naming-conventions.html