答案是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才算通过。

















