基于npm管理组件包feature branch版本的优化方案咨询

针对你遇到的React应用与自研组件跨分支依赖构建问题，以下是几个无需动态修改package.json版本号的可行方案：

方案1：直接引用Git分支/PR作为npm依赖 #

不用将组件发布到Artifactory，直接在App的feature分支package.json里指定组件的Git分支或PR地址：

"dependencies": {
  "@your-org/custom-component": "git+ssh://git@bitbucket.yourcompany.com:your-team/custom-component.git#feature/APP-456-update-button-api"
}

如果需要拉取PR的合并预览分支（Bitbucket会自动生成），可以直接指定PR的merge分支：

"@your-org/custom-component": "git+ssh://git@bitbucket.yourcompany.com:your-team/custom-component.git#pull-request/78/merge"

• 核心优势：完全跳过版本号修改和预发布流程，直接关联代码分支，构建时npm会自动拉取对应代码并执行组件的构建脚本（需确保组件仓库有prepare脚本）
• 注意事项：构建服务器需配置Bitbucket的SSH访问权限，确保能拉取私有仓库代码

方案2：利用Artifactory快照版本管理 #

将组件的package.json版本固定为带-SNAPSHOT的格式（比如1.0.1-SNAPSHOT），无需根据分支修改：

• 组件的feature分支构建后，发布到Artifactory的快照仓库（Artifactory支持快照版本的自动覆盖）
• App的feature分支直接依赖1.0.1-SNAPSHOT，npm会自动拉取最新的快照构建产物
• 组件合并到主线后，将版本改为正式版1.0.1并发布到Artifactory正式仓库
• 核心优势：快照版本天然区分预发布与正式版本，无需编写分支检测脚本，Artifactory自动管理快照历史
• 注意事项：需在Artifactory中配置快照仓库的版本覆盖规则，避免构建失败

方案3：迁移至Monorepo（npm Workspaces） #

将React应用与自研组件放到同一Git仓库，使用npm Workspaces管理依赖：

// 根目录package.json
{
  "name": "your-project-monorepo",
  "workspaces": [
    "packages/react-app",
    "packages/custom-component"
  ]
}

• 开发与构建时，App直接引用本地组件代码，无需发布到任何仓库
• 核心优势：彻底消除跨仓库的版本依赖问题，组件修改后App实时生效，无需处理任何版本号
• 注意事项：需要调整代码结构为monorepo模式，同步修改Bitbucket的权限与Bamboo的构建流程

方案选型参考 #

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