composer global require仅安装cli工具且需手动配置path才能调用；它不提供项目级库依赖，不加载autoload，--dev参数无效，禁用sudo，更新应按需单包执行而非全局update。
composer global require 不是“让所有项目都能用这个库”，它只装 CLI 工具，且必须手动把 bin 目录加进 PATH 才能用命令。
为什么 composer global require 装完命令还是报错
根本不是 Composer 没装成功，而是 shell 根本找不到生成的可执行文件。它被放在 ~/.composer/vendor/bin/（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows），但这个路径默认不在系统 PATH 里。
- Linux/macOS：检查
echo $PATH是否含$HOME/.composer/vendor/bin；没看到就追加export PATH="$HOME/.composer/vendor/bin:$PATH"到~/.zshrc（zsh 用户）或~/.bash_profile（bash 用户），然后source ~/.zshrc - Windows：在「系统属性 → 高级 → 环境变量」中，于「用户变量」的
Path里新增一行：%APPDATA%\Composer\vendor\bin（注意：不是%APPDATA%\Composer\bin） - 改完不重启终端 / 不重载配置，PATH 变更不会生效；IDE（如 PHPStorm）通常不继承 shell 的 PATH，需在设置里单独指定 CLI 解释器路径
- 验证是否生效：运行
which php-cs-fixer（macOS/Linux）或where php-cs-fixer（Windows），再执行php-cs-fixer --version
composer global require 能装什么、不能装什么
它只适合装**终端里直接敲命令就能跑的工具类包**，和项目运行时完全隔离——vendor/autoload.php 不加载它们，require 或 use 也找不到。
ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
- ✅ 合适场景：
laravel/installer（提供laravel new）、phpstan/phpstan、friendsofphp/php-cs-fixer、phpunit/phpunit - ❌ 绝对禁止：
monolog/monolog、guzzlehttp/guzzle这类业务逻辑库——部署时会缺失，本地和线上行为不一致 - --dev 参数会被忽略：
composer global require --dev phpunit/phpunit和不加一样，全局没有 dev 依赖概念 - 别用
sudo composer global require：权限错会导致后续所有全局操作失败；修复方式是chown -R $USER ~/.composer
怎么安全更新和清理全局包
composer global update 表面省事，实际风险高：它会强制拉取所有全局包的最新兼容版本，而不同工具依赖的 symfony/console、PHP 版本可能冲突，报错时连哪个包导致的都难定位。
- 先看哪些过期：
composer global outdated - 按需更新单个包：
composer global update friendsofphp/php-cs-fixer - 卸载用
composer global remove（Composer 2.2+），不要手动删~/.composer/vendor/下的目录 - 清理缓存：
composer clear-cache；重置全局配置出错时，直接删掉~/.composer/composer.json，再用composer config --global重建
多 PHP 版本共存时的坑
全局包绑定的是当前 CLI 的 PHP 版本。用 phpbrew 或 asdf 切换 PHP 后，旧全局包可能因扩展缺失而报 Class not found。
- 切换 PHP 版本后，必须重新运行
composer global install（或update），否则二进制仍链接旧环境 - 若团队需稳定工具链，
composer global不够可靠；改用phive或容器化分发（如 GitHub Actions 中显式composer global require）更稳妥 - 全局工具不解决项目级依赖冲突——它只是把开发辅助工具从
vendor/移出来；一旦需要多个 major 版本的phpstan，就得退回 per-project 安装
最常被忽略的一点：全局安装 ≠ 全局可用。它不改变任何项目的自动加载逻辑，也不参与依赖解析。你真正在意的“统一工具版本”，靠的是 PATH + 显式调用，而不是 autoload 或 require。
