手动编辑composer.json比命令更可靠，因其能精准控制镜像源顺序与禁用逻辑，避免全局配置因拼写、权限或shell隔离失效；必须显式禁用packagist.org并确保url结尾带斜杠，且需删除composer.lock后执行composer update方可生效。
直接改 composer.json 文件比命令更可靠
命令行配置容易因拼写、权限或上下文失效，而手动编辑 composer.json 能精准控制源顺序和禁用逻辑，尤其适合 CI/CD、多源项目或团队协作场景。
常见错误现象：执行 composer config -g repo.packagist 返回空，或 composer install -vvv 日志里仍出现 GET https://packagist.org/packages.json ——说明全局配置根本没生效，此时必须转向文件级修改。
- 打开项目根目录下的
composer.json，确保顶层有"repositories"字段（类型为object，不是array；若已是数组，需先转成对象） - 写入标准结构：第一项必须是
{"packagist.org": false}（显式禁用官方源，防止 fallback） - 第二项填镜像源：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意 URL 末尾的/不可省） - 已有私有源（如 Git VCS 或 Satis）可放在镜像前后，但不能删；它们与镜像共存，不冲突
composer.lock 必须重生成才能用上新镜像
镜像只影响元数据查询和 ZIP 包下载路径，但 composer.lock 里硬编码了每个包的 dist.url 和 source.url。只要 lock 文件没更新，composer install 就永远走旧地址。
所以“改完 composer.json 就跑 composer install”一定失败——它只会照着 lock 里原来的 https://packagist.org/ 去拉包，压根不看新配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉
vendor/和composer.lock（只删vendor不够） - 运行
composer clear-cache，否则缓存里残留的packages.json仍是官方源地址 - 再执行
composer update（不是install），让 Composer 重新解析依赖、查镜像、写新 lock - 确认新
composer.lock里所有dist.url都指向mirrors.aliyun.com或对应镜像域名
Windows 下 Git Bash 和 CMD 的配置隔离问题
在 Windows 上用 Git Bash 配置了全局镜像，结果 CMD 或宝塔面板里还是慢——因为 Composer 的全局配置文件路径在不同 shell 下不互通：%APPDATA%\Composer\config.json 是 CMD/PowerShell 的路径，而 Git Bash 默认读的是 Cygwin 或 MSYS2 的 home 目录下的 ~/.composer/config.json。
这不是镜像失效，是根本没读到配置文件。
- 检查当前终端实际使用的配置路径：运行
composer config --list --global，看home字段输出的是哪个目录 - 若用 Git Bash，确保修改的是
/c/Users/xxx/AppData/Roaming/Composer/config.json（而非~/下的伪路径） - CI/CD 或宝塔中以
www用户运行时，必须用sudo -u www composer config -g ...单独配，root 下的配置对它无效
项目级配置优先级高于全局，但会静默覆盖私有源
只要 composer.json 里存在 "repositories" 字段，全局配置就完全失效。这本身是设计行为，但容易引发意外：比如你加了阿里云镜像，却忘了保留原来定义的 Git 私有包源，结果 composer update 报错找不到私有包。
最容易被忽略的一点是：当 "repositories" 是数组（例如 [{"type":"vcs","url":"..."},{"type":"composer","url":"..."}]）时，composer config repo.packagist ... 命令会直接失败，不会合并，也不会报错提示。
- 手动编辑时，把
"repositories"改为对象格式："repositories": {"packagist": false, "aliyun": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}} - 私有 VCS 源建议保留在同一对象下，用唯一 key 标识，避免数组索引错位
- 改完后务必验证：
composer config repositories应输出完整结构，且不含packagist.org字样
