答案是path未正确配置：90%的“command not found”源于shell未在path中找到composer，需先用where composer（windows）或which composer（linux/macos）验证，再检查安装路径、权限、shell类型及配置加载链，并确保ide/ci环境变量已继承。
装不上、找不到命令、换源后还是慢——根本不是网络问题，是安装路径、权限或镜像配置写错了关键字段。
composer命令找不到？先确认它真在PATH里
不是没装成功，是终端压根找不到可执行文件。Windows用户双击Composer-Setup.exe后必须新开CMD/PowerShell；macOS用brew install composer最省事；Linux推荐这行命令一步到位：
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer
验证不能只跑composer --version，还得加一句composer diagnose。如果卡在Downloading https://packagist.org/packages.json，说明PATH没问题但网络不通——那是下一步要解决的。
- Windows：PATH没刷新，重启终端再试
- macOS：Homebrew装完自动加PATH，但zsh用户可能需
source ~/.zshrc - Linux：
/usr/local/bin必须在$PATH中，检查echo $PATH输出
镜像配置写错三个地方就静默失效
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/这行命令必须三要素齐全，缺一不可：
-
repo.packagist是固定键名，写成repos.packagist（多一个s）或repository.packagist都不报错，但完全不生效 -
composer是type值，不是命令名，漏掉它Composer会fallback到官方源 - URL末尾必须带
/，https://mirrors.aliyun.com/composer会拼出错误路径导致404
华为云镜像地址现在唯一有效的是https://repo.huaweicloud.com/repository/php/，旧地址如https://mirrors.huaweicloud.com/composer/已返回404。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更可靠，尤其适合CI和团队协作
全局配置写入~/.composer/config.json，但CI流水线常以www或runner用户运行，而-g配的是当前登录用户——权限不一致就失效。团队项目里，有人本地配了腾讯云，有人用了阿里云，composer install结果可能不一致。
更稳的做法是进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会直接写进composer.json的repositories字段，Git提交后所有人行为一致。注意：如果项目已有repositories数组，别手动覆盖，否则可能误删私有包源。
换源后仍卡在“Resolving dependencies”？和镜像无关
镜像只加速下载，不解决依赖解析慢的问题。如果你发现composer update卡在Resolving dependencies几十秒甚至几分钟，基本可以确定是以下原因：
- PHP版本约束太宽，比如
"php": "^7.4 || ^8.0" -
require-dev里塞了太多未锁定版本的工具链包 - 本地
php.ini禁用了proc_open或putenv，导致Composer无法启动子进程
验证是否被禁用：php -r "echo proc_open('echo 1', [], $p) ? 'ok' : 'fail';"，输出ok才算通过。
