composer报错主因是环境变量未生效、被覆盖或配置错误：composer_cache_dir路径须绝对且手动创建；repo.packagist键名和url格式必须正确；path重复导致windows执行失败；~/.composer/config.json权限或归属需匹配当前用户。
环境变量配置后 Composer 仍报错，90% 是变量没生效、被覆盖、或写错位置——不是配置动作失败，而是系统根本没读到你设的值。
COMPOSER_CACHE_DIR 覆盖 config 设置但路径不存在
这个环境变量优先级最高，一旦设了，composer config --global cache-dir 的结果完全被忽略。但 Composer 不会主动创建目录，也不会报“目录不存在”，只在写缓存时静默 fallback 到默认位置，导致你看到 composer diag 显示 Cache is not working due to permissions 或根本没反应。
- 先查是否被设：运行
echo $COMPOSER_CACHE_DIR（Linux/macOS）或echo %COMPOSER_CACHE_DIR%（Windows），非空就说明它在起作用 - 确认路径是绝对路径：
~/.cache/composer无效，必须写成/home/alex/.cache/composer或C:\Users\Alex\AppData\Local\Composer\Cache - 手动创建并修正归属：
mkdir -p /path/to/cache && sudo chown $USER:$USER /path/to/cache
repo.packagist 配置写错键名或 URL 格式
全局镜像不生效，几乎全是 repo.packagist 这个键名写错导致的。写成 repos.packagist、repositories.packagist、甚至漏掉 composer 类型参数，都会让 Composer 完全无视该配置，继续直连 packagist.org。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确命令必须带
composer类型参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
/结尾，否则拼出https://mirrors.aliyun.com/composer/packages.json变成https://mirrors.aliyun.com/composerpackages.json（404） - 验证是否写入成功：
composer config -g repo.packagist输出应为完整 JSON 对象，含"url": "https://..."，不是null或空行
PATH 中重复添加 Composer bin-dir 导致 CreateProcess failed
Windows 下报 CreateProcess failed 或 The system cannot execute the specified program，本质是 PATH 总长度超过 32767 字符。Composer 全局安装的命令（如 laravel、phpunit）被反复追加进 PATH 多次，尤其常见于 IDE 插件、旧版 Laravel Installer 或手动多次执行 composer config --global bin-dir 后又加 PATH。
- 检查当前长度：
echo %PATH% | powershell -Command "$input.Length" - 定位重复项：运行
composer config --global bin-dir，再搜索该路径在系统环境变量中出现几次 - 清理方法：进「系统属性 → 高级 → 环境变量」，在用户和系统两级 PATH 中，只保留一条该路径，且删掉所有重复项
- 更稳妥做法：不依赖 PATH，直接用绝对路径调用，例如
"%APPDATA%\Composer\vendor\bin\laravel.bat" new myapp
全局配置文件 ~/.composer/config.json 权限或缺失
重装系统、切换用户、或用 sudo 执行过 Composer 命令后，~/.composer/config.json 可能不存在、属主为 root、或权限为 600（其他用户不可读）。此时所有 composer config -g 命令看似成功，实则写入失败，配置根本没落地。
- 先确认文件存在：
ls -l ~/.composer/config.json；若报 “No such file”，运行mkdir -p ~/.composer再重试配置 - 检查属主：
ls -ld ~/.composer第三列必须是你当前用户名，否则sudo chown -R $USER:$USER ~/.composer - Windows 用户注意：路径是
%APPDATA%\Composer\config.json，不是C:\ProgramData\ComposerSetup\下的安装器配置文件
真正卡住的地方，往往不在报错那一行，而在环境变量是否被进程继承、路径是否被 shell 展开、或者某个配置项是否被更高优先级的设置覆盖——别急着重装或清缓存，先用 echo、ls -l、composer config -g 把变量和文件状态打出来看一眼。
