Composer的global命令与项目命令主要区别在于作用范围、安装路径及使用目的；2. global命令将包安装至全局目录（如~/.composer/vendor），适用于跨项目使用的CLI工具，而项目命令仅限当前项目使用；3. 全局命令修改的是全局composer.json文件，项目命令修改项目根目录下的composer.json；4. 使用composer global require前需确保全局vendor/bin路径已加入系统PATH，以便直接调用安装的命令；5. 安装后可通过composer global update更新所有全局包，composer global show查看已安装包；6. 应避免滥用global require，仅用于开发工具类应用，防止版本冲突和环境污染。
Composer 的 global 命令和项目命令（即在项目目录中执行的命令）主要区别在于作用范围、安装路径以及使用目的。理解这些差异有助于正确使用 composer global require 来安装全局工具。
global 命令与项目命令的区别
1. 安装位置不同
- 项目命令：composer require vendor/package 会将包安装到当前项目的 vendor/ 目录中，仅限该项目使用。
- 全局命令：composer global require vendor/package 会将包安装到 Composer 的全局目录，通常是用户主目录下的 ~/.composer/vendor（Linux/macOS）或 C:\Users\用户名\AppData\Roaming\Composer\vendor（Windows）。
2. 使用范围不同
- 项目依赖：只在当前项目中可用，通常作为代码库的一部分被引用。
- 全局工具：安装后可在系统任意位置通过命令行调用，适合 CLI 工具类应用，如 Laravel Installer、PHPStan、PHP-CS-Fixer 等。
3. composer.json 文件位置不同
- 项目命令修改的是项目根目录下的 composer.json。
- 全局命令修改的是全局的 ~/.composer/composer.json 文件（该文件在首次使用 global 命令时自动生成）。
如何正确使用 composer global require 安装全局工具
全局安装适合那些你希望在多个项目中重复使用的命令行工具。以下是正确操作方式：
步骤一：确保全局 vendor/bin 在系统 PATH 中
全局安装的可执行文件位于 ~/.composer/vendor/bin（Linux/macOS）或对应 Windows 路径。你需要把这个路径加入系统的环境变量 PATH，否则无法直接运行这些命令。
- Linux/macOS：在 shell 配置文件（如
~/.bashrc、~/.zshrc）中添加：
export PATH="$HOME/.composer/vendor/bin:$PATH"
- 保存后执行
source ~/.zshrc或重启终端。 - Windows：在系统环境变量中添加
%APPDATA%\Composer\Vendor\bin到 PATH。
步骤二：使用 global require 安装工具
例如安装 Laravel 安装器：
composer global require laravel/installer
安装完成后，可以直接运行：
laravel new my-project
步骤三：更新全局包
和其他依赖一样，全局包也需要定期更新：
composer global update
这会更新所有全局安装的包到最新兼容版本。
步骤四：查看已安装的全局包
运行以下命令查看当前全局安装了哪些包：
composer global show
加上 -i 参数可查看已安装的具体版本：
composer global show -i
常见问题与注意事项
不要滥用 global require
全局安装应仅用于开发工具，比如：
- 代码质量检测工具（PHPStan、Psalm）
- 格式化工具（PHP-CS-Fixer）
- 框架安装器（Laravel、Symfony CLI）
- 本地开发服务器（Laravel Valet）
业务项目的依赖必须使用本地 require，避免污染全局环境或引发版本冲突。
版本冲突风险
全局只有一个 vendor 目录，如果两个工具依赖同一个库的不同版本，可能会导致问题。因此建议保持全局安装精简。
权限问题
避免使用 sudo 执行 global 命令，否则可能导致文件归属错误。Composer 应以当前用户身份运行。
基本上就这些。正确使用 composer global require 能让你高效管理开发工具，关键是配置好 PATH 并保持全局环境整洁。
