SBT构建场景下如何实现CI任务端直接设置制品版本，无需依赖build.sbt

• 基于TeamCity/Jenkins等CI工具运行Scala项目的SBT构建流程
• 期望在构建执行阶段直接动态设置制品版本，不受build.sbt中预先配置的固定版本值约束
• 能力对标Java生态Maven的set-version目标：执行时临时设置制品版本，不修改原构建文件的版本定义，适配CI的动态版本生成规则

命令行临时覆盖方案（最贴近Maven set-version的原生能力） #

SBT本身支持命令行参数对构建配置的临时覆盖，不需要修改任何build.sbt文件内容，完全满足零侵入的要求：

• 执行构建命令时，直接在参数中追加版本赋值逻辑，示例命令：
  sbt 'version:=<CI动态生成的版本号>' clean publish
• 该机制下命令行传入的配置值优先级远高于build.sbt中的原有版本定义，执行过程不会改动磁盘上的build.sbt文件内容，多模块项目下该配置会自动全局覆盖所有子模块的版本值，无需逐模块单独配置，运行逻辑和Maven执行mvn versions:set -DnewVersion=xxx完全对齐。

环境变量适配方案 #

如果希望CI步骤不需要每次拼接复杂的sbt命令参数，可以在build.sbt中添加极简的版本读取逻辑，实现环境变量优先级覆盖：

• 将build.sbt中原本硬编码的版本配置，替换为优先读取环境变量的逻辑：
  version := sys.env.getOrElse("SBT_PROJECT_VERSION", "本地开发默认版本号")
• 适配逻辑：CI系统在执行构建前提前注入SBT_PROJECT_VERSION环境变量（值为CI动态生成的制品版本），SBT执行时会优先读取环境变量值作为正式制品版本；本地开发环境没有设置该环境变量时，会自动使用build.sbt中预设的本地默认版本，不影响日常开发体验。

• 两种实现方式均基于SBT原生能力，不需要引入第三方插件
• 动态版本值可以直接对接CI系统的内置能力生成，比如Jenkins的构建流水号、TeamCity的版本计数器、关联的Git标签值，不需要额外在构建脚本中做版本计算
• 后续执行publish、makePom等生成制品的步骤时，都会自动使用覆盖后的版本值，不会出现版本不匹配的问题

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