Composer怎么装工具_Composer全局工具安装方法【入门】

Composer全局工具安装：为什么装上了却用不了？

根本原因是PATH未包含Composer全局bin目录，需手动将$HOME/.composer/vendor/bin（Linux/macOS）或%APPDATA%\Composer\vendor\bin（Windows）加入系统PATH并重载配置，否则shell无法定位可执行文件。

用 composer global require 安装工具包确实简单，但安装成功绝不等于命令就能直接调用——除非你手动把那个隐藏的 vendor/bin 目录添加到系统的 PATH 环境变量里。

为什么 composer global require lara vel/installer 成功了却找不到 lara vel 命令

问题就出在路径隔离上。Composer 确实完成了它的工作：把包下载到全局目录，并在其中的 vendor/bin/ 下创建了可执行文件的软链接。然而，这个目录默认并不在系统搜索路径里。结果就是，你在终端里输入命令时，Shell 根本不知道要去哪里寻找它。

• 在 Linux 或 macOS 上，这个目录通常是 $HOME/.composer/vendor/bin（如果设置了 COMPOSER_HOME 环境变量，则路径为 $COMPOSER_HOME/vendor/bin）。
• 在 Windows 上，路径则是 %APPDATA%\Composer\vendor\bin（注意，是 vendor\bin，而不是 Composer\bin）。
• 有个快速定位的方法：先运行 composer config --global home 查看当前的 COMPOSER_HOME 目录；再运行 composer global config bin-dir --absolute，这个命令会直接输出完整的 bin 目录绝对路径。
• 千万别被 composer global list 显示的“已安装”状态迷惑了——这个列表只说明包已经躺在了 vendor 目录里，并不保证你在命令行里能调用它。

怎么让 lara vel、phpunit 这类命令真正生效

关键一步，就是把上面找到的那个 vendor/bin 路径，永久添加到系统的 PATH 环境变量中，并且重载配置使其生效。跳过这一步，百分之百会遇到 command not found 的错误。

• Linux/macOS 用户：打开你的 shell 配置文件（如果是 zsh 则是 ~/.zshrc，如果是 bash 则是 ~/.bash_profile），在文件末尾添加一行：
  export PATH="$HOME/.composer/vendor/bin:$PATH"
  然后，运行 source ~/.zshrc（或 source ~/.bash_profile）让配置立即生效。
• Windows 用户：打开「系统属性 → 高级 → 环境变量」，在「用户变量」区域找到并编辑 Path 变量，新增一行：
  %APPDATA%\Composer\vendor\bin
• 如何验证？
  在 Linux/macOS 终端运行 echo $PATH | grep composer，看看输出是否包含你的 composer 路径。
  在 Windows 命令提示符运行 echo %PATH%，检查路径是否存在。
  最后，直接试试新命令：lara vel --version 或 phpunit --version，能输出版本信息就大功告成。

composer global 不是独立命令，--dev 参数会被忽略

这里有个常见的语法误解：composer global 本身不是一个可执行的命令，单独运行它会报错。它实际上是一个命名空间前缀，后面必须跟上具体的子命令，比如 require、list、update。

• 所以，唯一正确的写法是：composer global require vendor/package-name。
• 另外，像 composer global require --dev phpunit/phpunit 这样的命令，其中的 --dev 参数是完全无效的。因为全局安装的包是跨项目使用的，Composer 在这里并不区分开发依赖和稳定依赖。
• 想要升级所有已安装的全局包？使用 composer global update。切记，不要手动删除 ~/.composer/vendor 目录，否则所有依赖它的命令行工具会立刻失效。
• 需要卸载某个全局包？Composer 没有 uninstall 命令，正确做法是使用 composer global remove vendor/package-name（此功能在 Composer 2.5 及以上版本支持）。

说起来，最容易踩的坑还不是路径配错，而是忘了重载配置。在 Linux/macOS 上，修改了 .zshrc 或 .bash_profile 后，如果不执行 source 命令，当前终端会话依然读不到新路径。Windows 用户也一样，修改环境变量后，必须重新打开一个命令提示符或终端窗口，新的 PATH 才会生效。旧窗口里的环境变量是不会自动更新的。