如何详细配置Window Composer全局命令及Composer环境？

本文共计875个文字，预计阅读时间需要4分钟。

Windows 上，通过以下步骤进行操作：

全局命令找不到？先确认 bin 目录路径是否真实存在

Composer 从不自动把 ~/.composer/vendor/bin（Windows 是 %APPDATA%\Composer\vendor\bin）加进系统 PATH。它只负责把可执行文件放进这个目录，其余全靠你手动补全。

• 运行 composer config --global home 查出全局根目录，再拼上 \vendor\bin 就是真实路径（例如 C:\Users\Alice\AppData\Roaming\Composer\vendor\bin）
• 用文件资源管理器打开该路径，确认里面真有你要的命令（比如 laravel.bat、phpunit.bat）
• 如果目录不存在或为空，说明 composer global require 执行失败，或包本身没声明 "bin" 字段

PATH 怎么加？Windows 用户必须分清用户级和系统级

在 Windows 上，PATH 加错位置会导致新开终端仍无效，尤其是用 Git Bash 或 VS Code 终端时容易误判。

• 推荐加到「用户变量」里的 PATH，而不是系统变量：控制面板 → 系统 → 高级系统设置 → 环境变量 → 用户变量 → PATH → 新建
• 粘贴完整绝对路径，不要用 %APPDATA% 占位符（PowerShell/CMD 会展开，但 Git Bash 不会）
• 加完必须关闭所有终端窗口，重新打开 CMD/PowerShell/VS Code —— 旧终端不会重载 PATH
• 验证是否生效：在新终端里运行 echo %PATH%，搜索你刚加的路径；再直接敲 laravel -V 看是否响应

为什么 composer config --global bin-dir 不起作用？

这个配置项只影响 composer install 时项目级 vendor/bin 的位置，和全局命令完全无关。它不控制 composer global require 输出的二进制文件放哪。

• bin-dir 是项目级配置，全局设了也无效（Composer 2.x 会静默忽略）
• 全局命令永远固定放在 %APPDATA%\Composer\vendor\bin，不能通过 config 改变
• 想改这个位置？只能设 COMPOSER_HOME 环境变量，但风险高：一旦路径权限不对或格式错误（如含空格未引号），composer global 全部失效

认证和镜像类配置必须用 --global 显式写入

Windows 下很多人在 PowerShell 里漏掉 --global，结果把 GitHub Token 或私有源账号写进了当前项目 composer.json，导致换项目就报 auth 错误。

• 设阿里云镜像：composer config --global repos.packagist composer https://mirrors.aliyun.com/composer/
• 设 GitHub Token：composer config --global github-oauth.github.com your_token_here
• 设私有仓库账号：composer config --global http-basic.repo.example.com username password
• 漏掉 --global？命令不会报错，但配置只存在于当前目录下的 composer.json，毫无全局意义

真正卡住人的从来不是 Composer 装没装上，而是 %APPDATA%\Composer\vendor\bin 这个路径有没有进 PATH、进的是哪个用户的 PATH、以及终端有没有重载——这三个点串起来，才是 Windows 下全局命令能跑通的最小闭环。