全局 Composer 镜像配置在项目存在 composer.json 或 composer.lock 时被忽略，必须修改项目级 repositories 字段；推荐用 jq 批量注入阿里云镜像，Windows 可用 PowerShell 调用 PHP 脚本处理，并需验证、备份及检查 CI/CD 环境变量。
为什么 composer config 全局设置不生效？
很多人执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，在项目里运行 composer install 仍走官方源，原因很直接：项目根目录存在 composer.json 或 composer.lock 时，Composer 会优先读取项目级配置（包括镜像源），全局配置被忽略。
所以批量修改必须落到每个项目的 composer.json 文件里，而不是只改全局。
- 检查是否已有项目级镜像：运行
composer config repo.packagist（在项目内） - 若输出为空或不是你期望的镜像地址，说明该项目没设镜像，需注入
-
composer.json中的repositories字段是关键，它会覆盖默认 packagist 源
用 jq 批量注入阿里云镜像（推荐 Linux/macOS）
jq 是最稳妥的 JSON 操作工具，不会破坏格式、注释或缩进（只要原始文件合法）。先确保已安装：brew install jq（macOS）或 apt install jq（Ubuntu/Debian）。
假设所有项目在 ~/projects/ 下，每个子目录是一个含 composer.json 的 PHP 项目：
find ~/projects -name "composer.json" -exec jq 'if has("repositories") == false then .repositories = [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}] else (.repositories |= map(select(.type == "composer" and .url | startswith("https://packagist.org")) |= {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}) // (.repositories += [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}])) end' {} \; -exec sed -i '' 's/ / /g' {} \; > /dev/null 2>&1
这段命令做了三件事：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 定位所有
composer.json； - 用
jq判断：无repositories→ 新增；有但含官方源 → 替换为阿里云；有且不含官方源 → 不动； - 最后用
sed统一缩进为两个空格（避免jq默认 4 空格破坏团队风格）
Windows 下用 PowerShell 替代方案
PowerShell 原生 JSON 支持较弱，直接解析易出错。更稳的方式是用 php 脚本处理——毕竟 Composer 本身就是 PHP 工具：
$jsonPath = "C:\projects\my-project\composer.json"
$content = Get-Content $jsonPath -Raw | ConvertFrom-Json
if (-not $content.repositories) {
$content | Add-Member -NotePropertyName repositories -NotePropertyValue @(@{type="composer"; url="https://mirrors.aliyun.com/composer/"})
} else {
$repo = $content.repositories | Where-Object { $_.type -eq "composer" -and $_.url -like "*packagist.org*" }
if ($repo) { $repo.url = "https://mirrors.aliyun.com/composer/" }
}
$content | ConvertTo-Json -Depth 10 | Set-Content $jsonPath
把上面保存为 set-mirror.ps1，再用 Get-ChildItem C:\projects -Recurse -Name "composer.json" 遍历执行即可。注意需启用脚本执行策略：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
- 别用
ConvertTo-Json -Compress，它会删掉换行和空格，导致composer validate报 warning - PowerShell 的
ConvertFrom-Json不保留字段顺序，但 Composer 不依赖顺序，可接受
验证与回滚：别跳过这步
改完不是就结束了。有些项目可能自定义了私有仓库，或用了 packagist.org 的子集镜像（如腾讯云），硬替换成阿里云可能触发认证或兼容问题。
- 进任意项目，运行
composer config repo.packagist，应输出https://mirrors.aliyun.com/composer/ - 运行
composer show -p | head -5，确认包列表能正常拉取（而非卡住或 404） - 备份建议：批量操作前，用
git status --porcelain | grep composer.json | cut -d' ' -f2 | xargs -I{} git add {} && git commit -m "backup composer.json before mirror switch"
真正容易被忽略的是：某些 CI/CD 流水线（比如 GitHub Actions）显式设置了 COMPOSER_REPO_PACKAGIST 环境变量，这种配置优先级高于 composer.json，脚本改了也没用——得同步检查 pipeline 配置。
