Composer命令未找到是因PATH未生效或路径污染；权限拒绝源于sudo导致属主为root；镜像失效因配置错误、项目级覆盖或未清缓存；Windows下PATH超长会触发CreateProcess失败。
报“command not found”：PATH没生效或路径污染
装完 Composer 但终端敲 composer -v 提示找不到命令，不是没装成功，而是 shell 找不到可执行文件位置。
- 先确认安装目标：
composer config -g bin-dir输出的路径（通常是~/.composer/vendor/bin或~/bin）是否真实存在且含可执行文件 - 检查该路径是否已加入
$PATH：运行echo $PATH，看输出里有没有那一串路径；Windows 用户用echo %PATH% - 若路径存在但未在
$PATH中，手动追加到 shell 配置文件（~/.zshrc或~/.bashrc），加一行：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc - Windows 上更常见的是 PATH 超长（>32767 字符）导致
CreateProcess failed，此时要删掉重复的 Composer bin 目录条目，只留一条，且放在 PATH 开头
报“Permission denied”：sudo 污染了全局目录
错误出现在 composer global require laravel/installer 后运行 laravel 命令时，大概率是 ~/.composer 或其子目录被 sudo 创建过，属主变成 root，而当前用户无权读写。
- 查归属：
ls -ld ~/.composer，若显示root root，说明已被污染 - 别用
chmod -R 777 ~/.composer——这不解决属主问题，还引入风险 - 正确做法：
sudo chown -R $USER:$USER ~/.composer，再补一句chmod u+w ~/.composer - Docker 或 CI 环境中，还要注意 UID 匹配：容器内用户 UID 和宿主机不一致时，挂载卷后文件不可写，应显式指定
-u $(id -u):$(id -g)
报“Could not fetch packages.json”：镜像配置静默失效
运行 composer global require 卡在 “Loading composer repositories”，日志却显示请求 packagist.org，说明你配的国内镜像根本没生效——它不是报错，是静默 fallback。
- 验证全局配置：
composer config -g repo.packagist必须输出完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、或仍是packagist.org都算失败 - 三个致命细节：键名必须是
repo.packagist（单数），type字段不能省略，URL 必须以/结尾（https://mirrors.aliyun.com/composer/✅，少斜杠就 404） - 项目级配置会覆盖全局：只要当前目录有
composer.json且含"repositories"字段（哪怕只是[]），全局镜像就彻底失效；此时应进项目目录运行composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 换源后必做：
composer clear-cache，否则旧缓存仍走原地址
报“CreateProcess failed”或“system cannot execute”：Windows PATH 超限
仅 Windows 出现，错误信息含 CreateProcess failed 或提示找不到 git、php、zip 等命令，本质是系统环境变量 PATH 总长度超过 32767 字符，PHP 进程 spawn 子进程失败。
- 测长度：
echo %PATH% | powershell -Command "$input.Length" - 定位污染源：打开「系统属性 → 高级 → 环境变量」，检查用户和系统两级 PATH，删掉所有重复的 Composer
bin-dir条目（比如%APPDATA%\Composer\vendor\bin被加了三次） - 最稳解法：不依赖 PATH，直接用绝对路径调用，例如：
"%APPDATA%\Composer\vendor\bin\laravel.bat" new myapp - 禁用自动 PATH 注入：某些 IDE 插件或旧版 Composer-Setup.exe 会在注册表或启动脚本里偷偷写 PATH，需手动清理
