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),右键选择“结束进程”。
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)。










