最快方案是用 jq 脚本一键切换，必须同时覆盖 composer_home（或 ~/.composer）全局配置、项目级 composer.json 的 repositories 及其类型，确保 url 完整、json 结构安全，并优先处理项目级源以避免被覆盖。
如何快速切换 Composer 镜像源（阿里云 / 清华 / 华为）
直接改 composer.json 或全局配置太慢，还容易漏改用户级和系统级配置；用脚本一键切是最稳的方案。关键不是“能不能切”，而是“切得全不全”——必须同时覆盖全局配置（~/.composer/config.json）、项目级配置（当前目录下 composer.json 中的 repositories），以及可能存在的 COMPOSER_HOME 自定义路径。
实操建议：
- 优先读取
COMPOSER_HOME环境变量， fallback 到~/.composer；别硬编码路径 - 镜像源必须用完整 URL，比如清华源是
https://mirrors.tuna.tsinghua.edu.cn/composer/，少斜杠或协议错误会导致composer update报Could not parse version constraint - 如果项目里已手动写死
repositories，脚本要能识别并替换，不能只动全局配置
脚本里怎么安全地修改 JSON 配置而不破坏格式
用 jq 工具最可靠，比正则替换或 PHP json_decode/json_encode 更准——尤其当配置里有注释（虽然官方不支持，但人常加）、换行缩进不一致时，jq 能保结构、验语法。
常见错误现象：手动 sed 替换后 composer install 报 JSON decode error，基本是引号没转义或逗号遗漏。
实操建议：
- 先用
jq -e '.repositories' $config_file >/dev/null 2>&1检查字段是否存在，再决定是 insert 还是 update - 替换时用
jq '.repositories = [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]'，不要拼接字符串 - 写入前用
jq '.' temp.json > $config_file，避免中断导致配置损坏
为什么切完镜像后 composer update 还走海外源
根本原因：Composer 会按优先级合并配置——项目级 composer.json 的 repositories > 当前目录 composer.lock 锁定的源 > 全局 config。脚本只改了全局，但项目里已有自定义源，就完全无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
使用场景：团队协作时，有人在 composer.json 里写了私有包源，你切镜像后 update 仍连不上私有仓库，是因为脚本没处理项目级配置。
实操建议：
- 脚本运行前加提示：
Found project-level repositories — will update them too - 对项目级
composer.json，只替换 type=“composer” 的条目，保留 type=“package” 或 “path” 的私有源 - 执行后跑一次
composer config --list | grep repo确认生效层级
Windows 下 PowerShell 脚本的坑与绕过方式
PowerShell 默认禁用脚本执行策略，且 jq 在 Windows 上路径空格、反斜杠、编码（UTF-8 with BOM）都会让 JSON 解析失败。这不是脚本写得不好，是环境限制。
性能影响：PowerShell 调用 jq.exe 比 WSL 里慢 300ms+，但比手动改 5 个文件快得多。
实操建议：
- 用
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser临时放开策略，别设成Unrestricted -
jq必须用官方 x64 版，从 https://stedolan.github.io/jq/download/ 下载，解压后加到 PATH - 读写 JSON 前统一用
Get-Content xxx.json -Encoding UTF8 | Out-String去 BOM
复杂点在于不同 Composer 版本对镜像源的解析逻辑略有差异，比如 2.5+ 支持 packagist.org: false 显式禁用默认源，而旧版本靠覆盖 packagist 条目。脚本得检测 composer --version 再决定怎么写配置。
