首先配置composer.json添加type为vcs的私有仓库地址，然后通过composer config --global设置Bitbucket用户名和App Password进行认证，接着在require中声明依赖并执行composer update即可安装私有包，遇到问题可检查密码权限、清除缓存或开启调试模式排查。
Composer 可以通过配置私有 Bitbucket 仓库来安装依赖包，关键是正确设置认证方式和仓库信息。
配置 Bitbucket 私有仓库
在项目的 composer.json 中添加仓库类型为 vcs（版本控制），并提供 Bitbucket 的 Git 地址：
{
"repositories": [
{
"type": "vcs",
"url": "https://bitbucket.org/username/private-repo"
}
]
}
Composer 会尝试从该地址拉取代码。由于是私有仓库，必须提供身份验证凭证。
设置身份验证凭据
使用 Composer 的全局配置存储 Bitbucket 账号信息，避免每次手动输入：
- 运行命令：
composer config --global http-basic.bitbucket.org username password - 其中
username是你的 Bitbucket 用户名 -
password推荐使用 App Password（应用密码），而不是账户主密码
App Password 需要在 Bitbucket 设置中创建，赋予“读取代码”权限即可。
添加依赖并安装
确保私有包的 composer.json 中定义了正确的 name 和 version 或使用分支别名。然后在主项目中添加依赖：
"require": {
"your-vendor/private-package": "dev-main"
}
执行 composer update，Composer 会通过认证连接到 Bitbucket 并下载包。
常见问题处理
如果遇到权限拒绝或无法克隆的问题：
- 确认 App Password 已启用且权限正确
- 检查 SSH 方式是否冲突（建议优先使用 HTTPS）
- 清除 Composer 缓存：
composer clear-cache - 开启调试模式查看详细错误：
composer install -vvv
基本上就这些。只要认证配置正确，Composer 能像处理 GitHub 私有库一样顺利拉取 Bitbucket 私有包。
