多个团队共用私有composer包需将包托管于内网git服务器（如gitlab），在composer.json中配置repositories为vcs类型并指定正确url；require时须显式声明dev分支或标签（如acme/utils:dev-main）；可通过全局config -g repositories统一管理源；更新失败时需clear-cache并加--no-cache强制刷新元数据。
怎么让多个团队共用一个私有 Composer 包
核心是把包托管在公司内网可访问的 Git 服务器（如 GitLab、Gitee 企业版、自建 Gogs），然后通过 Composer 的 repositories 配置告诉项目“去哪找包”，而不是依赖 packagist.org。
常见错误现象：Could not find package vendor/name at any version，本质是 Composer 根本没去你公司的 Git 仓库查，还在默认走 Packagist；或者 clone 时提示 Failed to clone https://git.example.com/xxx, could not read packages from it，多半是认证或 URL 写错了。
- Git 仓库必须开启
composer.json文件，并且name字段格式为vendor/package-name（如acme/utils），不能写成acme-utils或acme/utils-v1 - 在项目根目录的
composer.json中加repositories，类型选vcs，URL 填完整 Git 地址（https://git.example.com/acme/utils.git或git@git.example.com:acme/utils.git） - 如果用 SSH 地址，确保运行
composer install的机器已配置好 SSH key；如果用 HTTPS，可能需要提前配好 Git 凭据或在 URL 里带 token（不推荐明文写 token）
为什么 require 的时候总装不上 dev 分支或自定义标签
Composer 默认只认稳定版本（stable），而私有包往往还没打正式 tag，靠 dev-main 或 dev-develop 引入。不显式声明稳定性，它就直接跳过。
使用场景：刚开发完一个工具函数，想让另一个团队立刻试用，但又不想发 v1.0.0。
- require 时必须带上稳定性标识，比如：
composer require acme/utils:dev-main或composer require acme/utils:dev-develop - 也可以在项目
composer.json里设"minimum-stability": "dev"和"prefer-stable": true（后者保底用 stable，没得才退 dev） - Git 分支名要和远程一致；如果远程是
main，写dev-master就会失败（master是旧约定，新仓库默认是main） - 自定义标签（如
v1.0.0-rc1）需符合 Composer 版本约束规则，否则会被忽略；建议用标准语义化格式v1.0.0-rc.1
如何避免每个项目都重复写 repositories 配置
全局配置一次，所有项目自动继承，省得漏配、写错、后期改起来满世界找。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
性能影响几乎为零，只是多读一个 JSON 文件；兼容性上，Composer 2.0+ 均支持，旧版 1.x 不支持全局 repositories，得升级。
- 运行
composer config -g repositories.acme vcs https://git.example.com/acme/utils.git，其中acme是自定义源名，可任意 - 全局配置存在
~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows） - 注意：全局配置对所有项目生效，如果某项目明确在本地
composer.json里写了同名repositories，会覆盖全局的——这不是 bug，是设计行为 - 验证是否生效：运行
composer config -g repositories，看输出里有没有你的源
私有包更新后 composer update 没拉到最新代码
根本原因是 Composer 缓存了包的元数据（比如 commit hash、tag 列表），它不会每次主动刷新远程 Git 仓库状态。
容易被忽略的地方：你以为 composer update acme/utils 就会拉最新 dev-main，其实它只更新「已知版本」，新 commit 如果没触发重新扫描，就不会进候选列表。
- 先清缓存：
composer clear-cache（清的是整个缓存，安全） - 再强制重载元数据：
composer update acme/utils --with-dependencies --no-cache，--no-cache关键 - 更轻量的做法：删掉
vendor/acme/utils目录 +composer.lock里对应条目，再composer install - 长期建议：在 CI 流水线里加一步
composer update --no-cache，尤其发布新 tag 后
分支变动频繁时，别依赖 dev-main 长期上线；真要这么做，记得在 composer.json 里用 "acme/utils": "dev-main#abc123" 锁死具体 commit，不然下次 update 可能悄无声息切到别人刚 push 的未测代码。
