Composer报“Could not delete vendor/bin”错误是因该目录被IDE、终端、杀毒软件或资源管理器占用；解决办法包括：一、关闭占用进程；二、以管理员权限运行命令；三、用Resource Monitor手动结束占用进程；四、禁用快速启动和Windows Search服务；五、修改composer.json的bin-dir配置至自定义路径。
如果您在执行 Composer 命令时遇到 Could not delete vendor/bin 错误，通常是因为该目录或其中的可执行文件正被系统进程（如 IDE、终端、杀毒软件或 Windows 资源管理器）占用，导致 Composer 无法完成清理或更新操作。以下是多种针对性的解决办法：
一、关闭可能占用文件的开发工具
JetBrains 系列 IDE（如 PHPStorm）、VS Code、Sublime Text 等编辑器在启用“外部工具”或“终端集成”时，可能将 vendor/bin 目录下的脚本（如 phpunit、phpcs）作为解释器或调试目标长期持有句柄，造成删除失败。
1、完全退出 PHPStorm 或 VS Code，包括后台运行的进程（可在任务管理器中检查 code.exe 或 phpstorm64.exe 是否仍在运行）。
2、在 Windows 上按 Ctrl+Shift+Esc 打开任务管理器，切换到“详细信息”选项卡，查找并结束所有与 php.exe、composer.phar、phpunit 相关的进程。
3、重新打开终端并执行 composer install 或 composer update。
二、以管理员权限运行命令行工具
Windows 系统下，若当前用户对 vendor/bin 目录缺乏完全控制权限，或该目录被设置为只读/系统属性，Composer 将无法执行删除操作。提升执行权限可绕过部分 ACL 限制。
1、右键点击“Windows PowerShell”或“命令提示符”，选择“以管理员身份运行”。
2、使用 cd 命令进入项目根目录（确保路径中不含中文或空格）。
3、执行 composer clear-cache 清除本地缓存。
4、再执行 composer install --no-scripts --no-plugins，跳过可能触发文件锁定的脚本阶段。
三、手动解除文件占用并删除 vendor/bin
当自动删除失败时，需借助系统级工具定位并释放被占用的句柄。Windows 自带的 Resource Monitor 可直观显示哪个进程正在访问指定路径下的文件。
1、按下 Win+R，输入 resmon 并回车，打开资源监视器。
2、切换到“CPU”选项卡，在下方“关联的句柄”搜索框中输入 vendor\bin（注意双反斜杠转义）。
3、等待列表刷新，找到对应进程名（如 conhost.exe、phpstorm64.exe、avp.exe），右键选择“结束进程”。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
4、在资源管理器中手动删除 vendor/bin 文件夹（若仍提示占用，请重复步骤 2–3）。
5、执行 composer dump-autoload 重建自动加载映射。
四、禁用 Windows 快速启动与索引服务
Windows 快速启动（Hybrid Boot）会导致 NTFS 卷未完全卸载，残留内核级文件锁；而 Windows Search 服务会对新生成的可执行文件（尤其是 vendor/bin 下的 .bat/.exe）进行实时索引扫描，引发短暂但致命的占用。
1、以管理员身份运行 PowerShell，执行：net stop wsearch 暂停 Windows Search 服务。
2、进入“控制面板 > 电源选项 > 选择电源按钮的功能”，点击“更改当前不可用的设置”，取消勾选“启用快速启动”。
3、重启系统后，再次尝试 composer update。
4、操作完成后可重新启用 Windows Search 服务：net start wsearch。
五、切换 Composer 的 bin-dir 配置
默认情况下，Composer 将可执行脚本链接至 vendor/bin，该路径易受 IDE 和系统行为影响。修改为项目根目录下的独立子目录（如 tools），可规避常见占用路径冲突。
1、在项目根目录的 composer.json 中添加配置项：
"config": { "bin-dir": "tools" }
2、删除现有 vendor/bin 目录。
3、执行 composer install，此时所有 bin 脚本将生成于 tools/ 下。
4、将 ./tools 加入系统 PATH 或在脚本中显式调用（如 ./tools/phpunit）。
