composer全局安装命令报“command not found”的根本原因是全局bin目录（如~/.composer/vendor/bin或%appdata%\composer\vendor\bin）未加入系统path环境变量，导致shell无法定位可执行文件；需手动添加该路径到path并重载shell配置后方可使用。
Composer 本身不管理“全局依赖”，只提供 composer global require 这个机制来安装 CLI 工具；它不是为共享业务库设计的，误用会导致 autoload 冲突、版本不可控、PHP 环境错配——真正能稳定落地的只有明确隔离、路径可控、命令可验证的工具链。
为什么 composer global require 装完命令还是 command not found
根本原因不是没装上，而是 shell 根本找不到那个可执行文件。Composer 把 laravel、php-cs-fixer 这类命令软链接到 ~/.composer/vendor/bin/（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows），但这个路径默认不在系统 PATH 里。
- Linux/macOS：检查
echo $PATH是否含$HOME/.composer/vendor/bin；没看到就往~/.zshrc（zsh 用户）或~/.bash_profile（bash 用户）末尾加一行：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc - Windows：在「系统属性 → 高级 → 环境变量」中，把完整路径（如
C:\Users\Alice\AppData\Roaming\Composer\vendor\bin）加进「用户变量」的Path，不能写%APPDATA%—— 它在环境变量里不展开 - 改完必须新开终端，旧窗口不会重载
PATH；IDE（如 PHPStorm）通常不继承 shell 的PATH，需单独配置 CLI 解释器路径 - 验证是否生效：运行
which php-cs-fixer（macOS/Linux）或where php-cs-fixer（Windows），再执行php-cs-fixer --version
composer global require 能装什么、不能装什么
它只适合装你在终端里直接敲命令就能跑、且完全不参与项目运行逻辑的工具。这类包的 bin 字段声明了可执行入口，Composer 才会把它链进 vendor/bin/。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- ✅ 合适的包：
laravel/installer（命令是laravel）、phpstan/phpstan（命令是phpstan）、friendsofphp/php-cs-fixer（命令是php-cs-fixer）、symfony/cli（命令是symfony） - ❌ 绝对不能装：
monolog/monolog、guzzlehttp/guzzle、doctrine/orm—— 它们没有bin字段，装了也不会生成命令，还可能污染全局 autoload 映射，导致项目require失败 -
--dev参数会被忽略：composer global require --dev phpunit/phpunit和不加一样，全局没有 dev 依赖概念 - 别用
sudo composer global require：权限错会导致~/.composer归属 root，后续所有操作失败；修复要chown -R $USER ~/.composer
怎么安全更新和锁定全局工具版本
composer global require foo/bar:1.2.3 不会降级、不生成 composer.lock、也不覆盖已有的二进制文件——所以你敲 phpstan --version 还是旧版，很常见。
-
composer global update风险高：它会强制拉所有包的最新兼容版，而不同工具依赖的symfony/console或 PHP 版本可能冲突，报错时很难定位源头 - 想精确锁定版本，得手动进全局目录操作：
cd ~/.composer→composer require phpstan/phpstan:^1.10.3 --no-update→rm -rf vendor/→composer install（这一步才真正按composer.lock安装） - 多 PHP 版本场景下，
global没隔离能力；推荐用composer create-project单独安装：composer create-project phpstan/phpstan:1.10.3 ~/tools/phpstan-1.10.3，再写 wrapper 脚本显式调用对应 PHP - 清理装错的包，不能只删
composer.json条目；要先sed -i '/"phpstan\/phpstan"/d' ~/.composer/composer.json，再composer global update --no-interaction，最后手动检查~/.composer/vendor/bin/下是否残留可执行文件
国内用户绕不开的镜像与权限问题
不配镜像，composer global require 很大概率卡在 Resolving dependencies —— 不是 Composer 慢，是 packagist.org 的 DNS 和连接被干扰。
- 设阿里云镜像（全局生效）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 换完立刻清缓存：
composer clear-cache，否则旧源还在内存里继续试 - 阿里云镜像偶尔有几小时同步延迟；如果某个新版本死活拉不到，临时切回官方源：
composer config -g --unset repos.packagist - PATH 配错、镜像没清缓存、用了
sudo、shell 配置文件没重载——这四点占了国内用户 90% 的失败案例
全局工具管理最易被忽略的一点：它解决不了 PHP 版本混用、autoload 冲突、或多项目要求不同 major 版本工具的问题；一旦遇到 phpstan 8.x 和 9.x 共存，或需要同时支持 PHP 7.4 和 8.2 的静态分析，就得放弃 global，转向 create-project、phive 或容器化方案。
