优先检查文件是否被进程占用，如PHP服务、编辑器或杀毒软件锁定；尝试手动删除目标文件或目录，Windows可用del /F /Q，Linux/macOS用rm -f；必要时以管理员权限运行终端执行composer install；清除缓存可执行composer clear-cache；排除脚本干扰可用--no-scripts或--no-plugins选项；最后重新运行composer install或update完成安装。
当 Composer 报错 “Could not delete” 某个文件时，通常是因为该文件被系统或某个进程锁定，导致无法删除。这种情况在 Windows 系统中尤为常见，但也可能出现在 Linux 或 macOS 上。下面介绍几种常见的原因和解决方法。
检查文件是否被进程占用
最常见的原因是文件正被其他程序使用，例如：
- PHP 进程仍在运行（如开发服务器、队列监听等）
- 编辑器或 IDE（如 VS Code、PhpStorm）打开了相关文件
- 防病毒软件正在扫描文件
- Web 服务器（如 Apache、Nginx）持有文件句柄
你可以尝试以下操作：
- 关闭不必要的编辑器或终端窗口
- 停止本地开发服务器（如 php -S 或 Laravel Sail/Vite）
- 重启终端或命令行工具
- 在 Windows 上使用资源监视器（Resource Monitor）查找并结束占用文件的进程
手动删除文件
Composer 尝试删除失败后，可以尝试手动删除提示中的文件或目录：
- 找到报错中提到的路径，通常是 vendor/ 下的某个包目录
- 在文件管理器或命令行中尝试删除该目录
- 如果提示“文件正在使用”，说明仍被锁定
Windows 用户可尝试：
del /F /Q "path\to\the\file"
Linux/macOS 用户可尝试：
rm -f path/to/file
删除后重新运行 composer install 或 composer update。
以管理员权限运行 Composer
有时权限不足也会导致删除失败，尤其是在全局安装或修改受保护目录时：
- Windows：右键终端选择“以管理员身份运行”
- Linux/macOS：使用 sudo（仅在必要时）
sudo composer install
注意：不建议长期使用 sudo 执行 Composer，避免安全风险。
清理 Composer 缓存
如果问题反复出现，可能是缓存损坏：
composer clear-cache
这会清空 Composer 的下载缓存，下次安装时会重新下载包。
使用 Composer 的 --no-scripts 或 --no-plugins 选项
某些项目中的脚本或插件可能导致文件被提前加载，从而锁定文件：
composer install --no-scripts
或
composer install --no-plugins
逐步排除是否是 post-install-cmd 等脚本导致的问题。
基本上就这些。遇到“Could not delete”时，优先查占用、手动删、再重试。不复杂但容易忽略细节。
