“系统找不到指定的路径”是Windows无法正确解析PHP或Composer脚本路径所致，主因是PATH配置错误、未启用Win32长路径支持，或Git Bash/PowerShell等shell环境不兼容；需依次验证PATH、php.exe位置、composer.bat存在性，启用长路径并重启，优先使用CMD执行。
“系统找不到指定的路径”不是 Composer 坏了，而是 Windows 没法正确解析它要执行的 PHP 或自身脚本路径——本质是环境变量、长路径限制、或 shell 兼容性三者之一没对齐。
composer命令报“系统找不到指定的路径”时，先查PATH和php.exe位置
这个错误通常出现在运行 composer 时，而不是 composer install 过程中。它意味着 Windows 找不到 composer.bat 调用的 php.exe，或 composer.bat 本身不在 PATH 中。
- 运行
where composer：如果返回空，说明C:\ProgramData\ComposerSetup\bin没进系统 PATH（注意是「系统变量」，不是「用户变量」） - 运行
where php：确认 CLI 版本的php.exe是否在 PATH 中；XAMPP/MAMP 用户常漏配 CLI 的php.ini路径 - 手动检查
C:\ProgramData\ComposerSetup\bin\composer.bat是否真实存在；若用 Scoop 安装，则路径是C:\Users\{user}\scoop\shims\composer.bat - 不要依赖安装器“自动添加 PATH”的提示——Windows 下它常静默失败；必须手动验证并重启所有终端
Git Bash / PowerShell 中执行 composer 失败，多数因路径格式错乱
Git Bash 会把 C:\ProgramData\ComposerSetup\bin 自动转成 /c/ProgramData/ComposerSetup/bin，但 composer.bat 是 Windows 批处理，不认这种路径。PowerShell 有时也会因执行策略（ExecutionPolicy）阻止 .bat 运行。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 优先改用 CMD（非 Git Bash）执行所有
composer命令，避免路径翻译干扰 - 若必须用 Git Bash，加
winpty composer启动交互式命令（如winpty composer create-project） - 在 PowerShell 中临时放行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户，无需管理员） - 确保
COMPOSER_HOME设为 Windows 格式路径，例如C:\Users\YourName\AppData\Roaming\Composer，别用~/或$HOME
启用 Win32 长路径支持是绕过“路径不存在”类报错的前提
很多看似“找不到路径”的错误，实际是 Windows 在创建深层 vendor 子目录时触发 MAX_PATH 限制，直接返回“系统找不到指定的路径”，而非更明确的 “Path too long”。不开启这项，所有后续操作都是临时止痛。
- 专业版/企业版：运行
gpedit.msc→ 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用“启用 Win32 长路径” - 家庭版：注册表定位到
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，新建或修改LongPathsEnabled为DWORD = 1 - 修改后必须**重启系统**（只关终端无效），否则 PHP 进程仍读取旧策略缓存
- 验证是否生效：运行
php -r "var_dump(getenv('LongPathsEnabled'));"，输出bool(true)或string(1) "1"即可
PATH 过长或含非法字符也会触发同一错误提示
Windows 的 CreateProcess API 对环境变量总长度敏感。PATH 超过 ~2048 字符，或含未转义空格、中文、控制字符，会导致启动 composer.bat 时直接失败，报错就是“系统找不到指定的路径”。
- 运行
echo %PATH% | powershell -Command "$input.Length"查当前长度；超 2000 就得清理 - 删掉重复路径（比如多个
php目录）、废弃工具路径（旧 Node.js、Python 2.x）、带空格的路径（如C:\Program Files\...应改用C:\Progra~1\...） - 避免在 PATH 中直接写带空格路径；必须加引号的，应改用短路径别名（如用
C:\p\php替代C:\Program Files\php） - 检查杀毒软件是否劫持了 PATH 注入——某些国产安全软件会在 PATH 开头插入自己的监控 DLL 路径，导致截断
真正卡住的地方往往不是 composer.json 写错了，而是系统连 php.exe 的父目录都走不进去。PATH、长路径、shell 类型，这三样对齐了，90% 的“系统找不到路径”就自然消失。别急着重装，先让 Windows 明白它该去哪找东西。
