如何将Bitbucket私有仓库配置为Composer的依赖源？（SSH/OAuth）

要让 Composer 从 Bitbucket 私有仓库拉取依赖，必须配置 SSH 密钥或 App Password 实现身份认证：SSH 方式需确保本地 Git 可克隆、密钥已添加至 Bitbucket 并在 composer.json 中使用 git@bitbucket.org:username/repo.git 格式；App Password 方式需在 Bitbucket 创建只读密码，通过 composer config -g http-basic.bitbucket.org 用户名 密码 配置全局凭据，并在 composer.json 中使用 HTTPS URL；验证时可用 composer config -g --list、composer diagnose 和 composer install -v 检查，注意 name 字段一致性、URL 大小写及 CI/CD 环境单独配置。

要让 Composer 从 Bitbucket 私有仓库拉取依赖，核心是解决身份认证问题。Bitbucket 不允许匿名访问私有库，所以必须配置 SSH 密钥或 OAuth（App Password），并让 Composer 能正确使用它们。下面分两种主流方式说明，重点讲清关键步骤和容易出错的地方。

用 SSH 方式接入私有仓库

SSH 是最常用、也最稳定的方式，适合团队开发环境。前提是你的本地 Git 已能通过 SSH 克隆该私有仓库（比如 git clone git@bitbucket.org:username/repo.git 能成功）。

• 确保 SSH 密钥已添加到 Bitbucket 账户：生成密钥（如未有）ssh-keygen -t ed25519 -C "your_email@example.com"，再把 ~/.ssh/id_ed25519.pub 内容粘贴到 Bitbucket → Settings → SSH keys
• 在 composer.json 中声明仓库类型为 vcs，URL 使用 SSH 格式：
  "repositories": [{ "type": "vcs", "url": "git@bitbucket.org:username/private-package.git" }]
• Composer 默认会复用系统 SSH 配置，无需额外设置；但若你用了非默认密钥路径或别名，需在 ~/.ssh/config 中配好 Host 别名，并确保 git 命令能连通

用 App Password（OAuth 替代方案）方式接入

Bitbucket 已弃用 OAuth 1.0a，现在推荐用「App Password」——本质是带权限的密码，比明文账号密码更安全，且可单独控制权限范围。

• 在 Bitbucket 网页端进入 Settings → App passwords → Create app password，勾选 Repositories: Read（如果只是拉依赖，不需要写权限）
• 生成后立即复制保存（仅显示一次），例如得到密码 AtBcD3fGhIjKlMnOpQrStUvWxYz12
• 在终端运行：
  composer config -g http-basic.bitbucket.org username AtBcD3fGhIjKlMnOpQrStUvWxYz12
  其中 username 是你的 Bitbucket 用户名（不是邮箱）
• 在 composer.json 中使用 HTTPS URL：
  "url": "https://bitbucket.org/username/private-package.git"

验证与调试技巧

配置完别急着 composer install，先确认是否生效：

标签： word js git json composer github app ai 邮箱 开发环境 asic