如何用SBT将Scala项目的Jar包发布到GitLab包仓库？

核心结论：完全可以用SBT搞定 #

GitLab的包仓库支持Maven规范，而SBT本身完全兼容这套规范，不需要切换到Maven或Gradle，用你熟悉的SBT就能完成发布和后续引用。

先解决你困惑的点：Maven仓库与Jar包的关系 #

别纠结Maven这个工具，Maven仓库只是个存储Jar包的标准化结构仓库，它用groupId:artifactId:version三个参数作为每个Jar包的唯一标识。不管是SBT、Maven还是Gradle，都能识别这套标识规则，所以你的Scala Jar包只要按这个规则配置，就能传到GitLab的Maven仓库，其他Scala项目也能轻松找到并引用它。

具体操作步骤 #

1. 给SBT项目添加发布支持 #

在项目根目录的project/plugins.sbt文件中添加（如果没有这个文件就新建）：

// 可选：如果GitLab要求包签名才需要，否则可以跳过
addSbtPlugin("com.typesafe.sbt" % "sbt-pgp" % "2.1.2")
// 辅助发布的插件，也可以直接用SBT原生发布能力
addSbtPlugin("org.xerial.sbt" % "sbt-sonatype" % "3.9.13")

2. 配置项目标识与GitLab仓库信息 #

在项目根目录的build.sbt中添加以下配置：

// 项目的唯一标识（其他项目引用时会用到）
organization := "com.your-group" // 填你的GitLab用户名或项目组名，比如你的GitLab账号是foo，就填com.foo
name := "your-project-name" // 你的Scala项目名称
version := "1.0.0" // 版本号，每次发布必须更新，GitLab不允许同版本重复发布

// 配置GitLab包仓库的上传地址，替换[你的项目ID]为实际项目ID（GitLab项目主页设置里能找到）
publishTo := Some("GitLab Package Registry" at "https://gitlab.com/api/v4/projects/[你的项目ID]/packages/maven")

// 配置GitLab认证信息：不要硬编码令牌，用环境变量更安全
credentials += Credentials(
  "GitLab Maven Repository",
  "gitlab.com",
  "gitlab-ci-token", // 本地发布可以换成你的GitLab用户名，CI/CD用这个固定值
  sys.env.getOrElse("GITLAB_TOKEN", "") // 本地测试可以直接填你的个人访问令牌，或者用环境变量
)

// 告诉SBT按Maven格式发布，GitLab需要这个配置
publishMavenStyle := true

注意：个人访问令牌需要在GitLab的「用户设置-访问令牌」里生成，要勾选api和write_package_registry权限；项目ID在GitLab项目主页的「设置-通用」里能找到。

3. 执行发布命令 #

如果是本地发布，先设置环境变量GITLAB_TOKEN为你的个人访问令牌，然后在项目根目录运行：

sbt publish

执行成功后，去GitLab项目的「包仓库」页面就能看到你的Jar包了。

4. 在其他Scala项目中引用这个包 #

在目标项目的build.sbt中添加以下配置：

// 添加GitLab仓库地址，替换[你的项目ID]
resolvers += "GitLab Package Registry" at "https://gitlab.com/api/v4/projects/[你的项目ID]/packages/maven"

// 私有仓库需要配置认证，和发布时的规则一致
credentials += Credentials(
  "GitLab Maven Repository",
  "gitlab.com",
  "gitlab-ci-token",
  sys.env.getOrElse("GITLAB_TOKEN", "")
)

// 引用你的包，坐标要和发布时完全一致
libraryDependencies += "com.your-group" %% "your-project-name" % "1.0.0"

注：%%是SBT的语法，会自动匹配当前项目的Scala版本，如果你的Jar包是跨版本编译的，可以换成%。

常见踩坑点 #

• 版本号不能重复：GitLab禁止同一标识的同版本包重复发布，每次发布要更新版本号（比如用1.0.1、1.0.0-SNAPSHOT）。
• 权限问题：确保你的访问令牌有足够的权限，私有仓库必须配置认证才能访问。
• 网络问题：如果访问GitLab较慢，可配置代理后再执行发布命令。

内容的提问来源于stack exchange，提问作者WiseUser