如何在TeamCity中将分支名传递给快照依赖项

针对你描述的场景——仓库A的PR分支R构建时，触发依赖的仓库B构建并传递分支R作为参数，我整理了一套可行的步骤，基于TeamCity的参数传递和快照依赖机制：

步骤1：在仓库A的构建配置中定义分支参数 #

首先在A的构建配置里添加一个自定义参数，用来捕获当前PR的源分支（也就是你说的分支R）：

• 进入A的构建配置 → 参数 页面，点击"添加新参数"
• 参数类型选择环境变量（或者系统参数，根据你的习惯），名称设为env.A_PR_BRANCH
• 参数值填写%teamcity.pullRequest.source.branch%——这个是TeamCity针对PR构建的内置参数，会自动获取PR的源分支名；如果分支名带有refs/heads/前缀，可通过字符串处理去掉：%teamcity.pullRequest.source.branch.replace('refs/heads/', '')%
• 在参数的高级设置里，勾选**"Pass to dependent builds"**，确保这个参数能传递给依赖的B构建

如果你的场景不是PR触发，而是手动分支构建，把参数值换成%teamcity.build.branch%即可。

步骤2：确认快照依赖的参数传递设置 #

因为B是A的快照依赖，TeamCity默认会传递已标记为可传递的参数，但需要确认依赖配置的正确性：

• 进入B的构建配置 → 依赖 页面
• 确保快照依赖指向A的构建配置，并且在依赖的高级选项中，勾选**"Use snapshot dependencies"**，同时确认"Do not run new build if there is a suitable one"的设置符合你的需求（一般保持默认即可）

步骤3：在仓库B的构建步骤中使用传递的参数 #

现在B的构建已经能拿到A传递过来的分支参数了，直接在需要的步骤里引用即可：
比如在B的命令行构建步骤中，把分支R作为参数传入，命令可以写成：

your-build-command --target-branch %env.A_PR_BRANCH%

如果之前用的是系统参数，就写成%system.A_PR_BRANCH%，保持和A中参数类型一致。

额外调试与注意事项 #

• 验证参数传递：可以在B的构建步骤里加一个打印参数的命令，比如echo "Received PR branch from A: %env.A_PR_BRANCH%"，查看构建日志确认参数是否正确
• TeamCity版本兼容：确保你的TeamCity版本支持PR相关的内置参数（一般2020.1及以上版本对主流Git平台的PR集成更完善）

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