根本原因是全局bin目录未加入系统PATH；需用composer config --global home确认路径，再将对应/vendor/bin添加至shell或系统环境变量，重载配置后验证echo $PATH或echo %PATH%及命令执行。
composer global require装了命令却找不到
根本不是没装成功，而是生成的可执行文件（比如 laravel、think）被放进了 ~/.composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows），而这个路径压根不在系统 PATH 里。
实操建议：
- 先确认真实 bin 路径：
composer config --global home输出后拼上/vendor/bin，例如$HOME/.composer/vendor/bin - Linux/macOS：在
~/.zshrc或~/.bashrc中追加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc - Windows：把
%APPDATA%\Composer\vendor\bin添加到「系统环境变量」→Path→ 新建，**必须重启 CMD/PowerShell 才生效** - 验证方式：新开终端，运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），搜索是否含该路径；再试laravel --version - 别用
sudo composer global require——它会把文件写进/root/.composer/vendor/bin，普通用户永远碰不到
COMPOSER_HOME 设错导致全局配置“写对了但没生效”
这个环境变量是 Composer 查找全局配置的唯一入口。设错一个字符，所有 composer config --global 写入的内容都会存到错误位置，后续读取全失败。
实操建议：
- Windows 必须用绝对路径，如
C:\Users\YourName\AppData\Roaming\Composer；不能写%APPDATA%\Composer（PowerShell 会展开，Git Bash 不会，Composer 自己不解析） - Linux/macOS 必须用
/home/yourname/.composer这类绝对路径；~/.composer或$HOME/.composer会被静默忽略 - 设完必须关闭所有已打开终端，重新启动 CMD/PowerShell，否则进程仍读旧环境值
- 唯一验证方式：
composer config --list --global，第一行 “Global configuration file” 显示的路径必须和你设的COMPOSER_HOME完全一致
镜像源配了但 composer install 还是走 packagist.org
不是配置没保存，而是被更高优先级设置覆盖了。Composer 的源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 进项目目录后运行
composer config repo.packagist（不带-g），如果输出仍是镜像 URL，说明项目级配置生效中 - 检查
composer.json是否含"repositories": []或"repositories": {}——哪怕空数组也会屏蔽全局镜像 - CI/CD 或 Docker 构建时，
composer config -g可能写进了容器临时/root/.composer，但构建用户是www-data，根本读不到 - 最准验证方式：
composer install -vvv 2>&1 | grep "Downloading.*packages.json"，看日志第一行是不是你设的镜像域名 - 改完镜像必须跟
composer clear-cache，否则缓存里的旧packages.json仍指向境外地址
Permission denied 写入 ~/.composer/vendor/bin 怎么办
现象是 composer global require 报 failed to open stream: Permission denied。根本原因不是磁盘满，而是该目录或其父目录归属为 root，或权限被锁死。
实操建议：
- 检查归属：
ls -ld ~/.composer ~/.composer/vendor ~/.composer/vendor/bin，若任一目录所有者不是当前用户，就出问题了 - 修复命令：
sudo chown -R $USER:$USER ~/.composer（慎用sudo，仅当确认归属异常时） - 避免后续再出问题：永远不要用
sudo composer global require——它会让生成的二进制文件属于root，后续无法覆盖或执行 - 如果已误用
sudo，除了改归属，还要删掉~/.composer/vendor/bin/laravel等残留文件再重装 - 全局安装失败，95% 不是 Composer 本身坏了，而是
composer命令根本没进系统PATH，或者全局bin目录权限/归属不对
最容易被忽略的是：COMPOSER_HOME 和 PATH 必须同时正确且生效，缺一不可；而 composer diagnose 根本不验证这两项，它只报 PHP 版本和扩展状态。
