Composer命令跑不起来首要排查PHP环境与PATH配置，其次确保全局镜像命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/三要素齐全：键名必须为单数repo.packagist、中间composer为必填type值、URL须HTTPS且末尾带/，缺一即静默失效。
composer命令根本跑不起来？先确认PHP和PATH
不是镜像没配好，是环境根本没就位。Composer本质是PHP脚本，php -v报错时，composer --version必然失败——别急着敲镜像命令。
常见卡点：
- PHP未安装，或安装后没加进系统PATH
- 哪怕用Composer-Setup.exe装完，新版默认不勾选
Add to PATH，导致终端找不到composer - PATH改完后没新开终端，旧CMD/PowerShell不会自动加载新路径
验证方式：运行echo %PATH%（Windows）或echo $PATH（Linux/macOS），确认输出里含C:\ProgramData\ComposerSetup\bin（Windows）或/usr/local/bin等实际路径。
全局镜像命令必须三要素齐全，缺一即静默失效
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/这行命令不是“大概对就行”，漏掉任意一项都不会报错，但实际不生效。
三个硬性条件：
-
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） - 中间的
composer是type值，不是可选参数，不能省略或替换成composer.org - URL必须是HTTPS且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致404）
执行后务必验证：composer config -g repo.packagist，输出必须是完整JSON对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null或显示https://packagist.org，说明没写进去。
CI/宝塔/计划任务里镜像不生效？用户权限不一致是根源
全局配置写在%USERPROFILE%\AppData\Roaming\Composer\config.json（Windows）或~/.composer/config.json（Linux/macOS），但它只对当前Windows用户有效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
宝塔后台、Docker容器、CI流水线常以www或root用户运行，根本读不到你的个人配置。
更稳妥的做法是项目级配置：
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动写入
composer.json的repositories字段，Git可跟踪，不受用户影响 - 注意：项目级配置优先级高于全局，只要
composer.json里有repositories，就会被覆盖且不报错
多用户环境（如宝塔）下，必须切换用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
换源后还是卡在“Loading composer repositories”？清缓存和旧文件是关键
Composer会优先读取本地缓存和composer.lock中记录的元数据地址，哪怕你已经改了镜像，它也可能还在用旧URL。
必须连贯操作：
- 先运行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirro（注意日志截断）
如果仍卡住，检查是否误用了已停服的镜像（如https://packagist.phpcomposer.com），或企业网络拦截HTTPS请求导致证书校验失败——此时可临时加-n跳过验证：composer install -n（仅限可信环境）。
