需在 composer.json 中配置 repositories 为 vcs 类型并指定 Fork 的 GitHub 地址，require 版本写为 dev-分支名（如 dev-main），同时确保 minimum-stability 允许 dev 版本，最后运行 composer update vendor/package-name 验证 source 是否指向你的仓库。
怎么让 Composer 装你 Fork 的包而不是原版
直接改 composer.json 里的 "require" 是没用的——Composer 默认只认 Packagist 或已注册的源。必须显式告诉它：“这个包，去我 Fork 的 GitHub 地址拉”。核心动作就两步：加 repositories 配置 + 锁定具体 dev- 分支或 commit。
-
repositories类型必须是"vcs"（不是"package"，后者要手写完整元数据，容易出错） - URL 填你 Fork 后的仓库 HTTPS 地址，比如
"https://github.com/yourname/package-name"，别填原作者的 -
"require"中版本号得写成"dev-main"或"dev-develop"，不能写"^2.0"——否则 Composer 还是去找 Packagist 上的稳定版 - 如果原包用了
composer.lock，执行composer update vendor/package-name，别用install，否则可能沿用旧锁
为什么装了还是跑原包的代码
最常见原因是分支名对不上。你 Fork 后默认是 main 或 master，但原包可能用 develop、next 甚至自定义分支发布开发版。Composer 拉不到对应分支，就会 fallback 到 Packagist 的最新稳定版。
- 先用
git ls-remote https://github.com/yourname/package-name看你 Fork 仓库里有哪些分支和 tag - 确保
composer.json里 require 的版本字符串和你 Fork 仓库中实际存在的分支名一致，比如"dev-fix-login-bug" - 运行
composer show vendor/package-name，检查输出里的source字段是否指向你的 GitHub 地址，不是原作者的 - 如果用了
minimum-stability: stable，它会自动忽略所有dev-版本，得临时改成"minimum-stability": "dev"或加"prefer-stable": true配合
怎么避免每次改完都要手动 update
靠 path 仓库类型最省事，适合本地快速验证修改，但别提交到生产环境的 composer.json 里——它不跨机器，CI 会失败。
- 把 Fork 的代码 clone 到本地某个路径，比如
../my-forked-package - 在项目根目录
composer.json的repositories里加一条：{"type": "path", "url": "../my-forked-package"} -
require写成"vendor/package-name": "*"，Composer 会自动 link 到本地路径 - 改完 Fork 的代码，不用
update，直接 reload 就生效；但注意：这个路径必须是绝对路径或相对于composer.json的相对路径，且不能含..越界（某些 Composer 版本会拒绝）
私有 Fork 怎么处理认证问题
如果你 Fork 的是私有仓库，或者想走 SSH 而非 HTTPS，Composer 默认不会读取系统 SSH agent 或 ~/.gitconfig，得显式配置。
- HTTPS 私库：在
repositories.url里直接塞 Token，格式为"https://<code>your-token@github.com/yourname/repo"（Token 需有repo权限） - SSH 私库：URL 改成
"git@github.com:yourname/repo.git"，并确保本地ssh-add -l能列出对应密钥；Composer 7+ 支持git_ssh_command环境变量微调 - 别在
composer.json里硬编码 Token，用auth.json更安全：{"github-oauth": {"github.com": "xxx..."}}
分支名拼错、最小稳定性卡住、本地 path 路径越界——这三个点卡住的人最多。改完记得 composer show 看 source，别只信 update 输出的 “nothing to install”。
