答案是未将%APPDATA%Composerendorin添加到Windows用户环境变量PATH中；需运行composer config --global home确认路径，手动添加绝对路径（如C:UsersAliceAppDataRoamingComposerendorin）至用户变量Path，关闭并重开所有终端后验证laravel -V。

Windows 下 composer global require 命令找不到？先查 %APPDATA%Composerendorin 是否真实存在

根本原因不是安装失败，而是 shell 根本没看到这个目录——composer global require 只负责把可执行文件（比如 laravel.bat、phpunit.bat）放进 %APPDATA%Composerendorin，它从不自动加 PATH。

操作步骤：

• 运行 composer config --global home，确认输出是类似 C:UsersAliceAppDataRoamingComposer 的绝对路径
• 手动用文件资源管理器打开该路径 + endorin，检查里面是否有你刚装的命令文件（注意：.bat 文件必须存在，不能只有 .php）
• 如果目录不存在或为空，说明 composer global require 执行时出错（比如网络中断、包没声明 "bin" 字段），重试前先清缓存：composer clear-cache

Linux/macOS 用户别写 ~/.composer/vendor/bin，要用 $HOME/.composer/vendor/bin 或 $(composer global config bin-dir --absolute)

~ 在 shell 配置文件里不会被展开，直接写会导致 PATH 无效；更稳妥的方式是让 Composer 自己吐出绝对路径。

实操建议：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 在 ~/.zshrc（zsh 用户）或 ~/.bash_profile（bash 用户）末尾加一行：
  export PATH="$(composer global config bin-dir --absolute):$PATH"
• 保存后必须运行 source ~/.zshrc（或对应配置文件），否则当前终端仍无效
• 验证：新开终端，运行 echo $PATH | grep composer，应能看到完整路径（如 /home/alice/.composer/vendor/bin）

Windows 用户加 PATH 必须用「用户变量」+ 绝对路径，禁用 %APPDATA% 占位符

Git Bash、VS Code 终端、PowerShell 都不统一解析环境变量占位符，%APPDATA%Composerendorin 在 Git Bash 里就是字面字符串，根本不会展开成真实路径。

正确做法：

• 控制面板 → 系统 → 高级系统设置 → 环境变量 → 「用户变量」→ 「Path」→ 新建
• 粘贴完整绝对路径，例如：C:UsersAliceAppDataRoamingComposerendorin（不能含任何 % 符号）
• 加完立刻关闭所有已打开的终端（CMD、PowerShell、Git Bash、VS Code 内置终端），再全新启动
• 验证：echo %PATH% 搜索关键词 Composer；再直接运行 laravel -V 看是否响应

IDE（如 PHPStorm）不继承终端 PATH，需单独配置 CLI 解释器路径

即使终端里 phpunit 能跑，PHPStorm 的 Terminal 或 Run Configuration 仍可能报 command not found——因为 IDE 启动时读的是系统级或注册表级 PATH，不是你 shell 配置的那套。

解决方式：

• PHPStorm：Settings → PHP → CLI Interpreter → 点右下角「…」→ 在弹窗中点「Environment variables」→ 手动添加 PATH，值填和终端一致的完整路径（如 C:UsersAliceAppDataRoamingComposerendorin;...）
• VS Code：检查 terminal.integrated.env.windows 设置，必要时在 settings.json 中显式注入：
  "terminal.integrated.env.windows": { "PATH": "C:\Users\Alice\AppData\Roaming\Composer\vendor\bin;%PATH%" }
• 不要依赖「自动检测」，尤其在 Windows 上，IDE 很少能正确继承用户级 PATH 的变更

实际配置中最容易被跳过的环节，是关闭并重开所有终端——旧窗口的环境变量进程不会刷新，PATH 加得再准也没用。另外，COMPOSER_HOME 如果被手动设过，必须确保它指向的路径和 composer config --global home 输出一致，否则 bin-dir 会指向错误位置。