Windows下Composer install/update卡在“rename(): Cannot rename…”是因杀毒软件、Windows Search等进程锁定临时目录，导致PHP重命名失败；可用资源监视器定位占用进程，通过禁用索引、添加杀软排除项或执行composer install --prefer-dist --no-cache临时解决。
Composer install/update 时卡在 “rename(): Cannot rename…” 错误
这是 Windows 下 Composer 最典型的文件占用问题：Composer 在解压包后尝试将临时目录 vendor/composer/xxx-temp 重命名为目标包路径（如 vendor/vlucas/phpdotenv），但失败并报 rename(): Cannot rename。根本原因不是权限不足，而是该临时目录下的某个文件正被其他进程（常见为杀毒软件、Windows Search、IDE 文件监听器、甚至 Explorer 预览窗格）锁定，导致 PHP 的 rename() 系统调用失败。
- 错误典型提示：
rename(C:\path\to\vendor\composer\abc123-temp, C:\path\to\vendor\package/name): Permission denied - 只在 Windows 出现，Linux/macOS 无此问题（底层文件系统语义不同）
- 不是 Composer 配置问题，改
COMPOSER_CACHE_DIR或加--no-plugins通常无效 - 重启 CMD/PowerShell 也没用——锁是跨进程的，不随终端关闭释放
快速验证是否被第三方进程占用
不用装新工具，用 Windows 自带的 resmon.exe（资源监视器）就能定位：
- 按
Ctrl+Shift+Esc打开任务管理器 → 切换到「性能」页 → 底部点「打开资源监视器」 - 切换到「CPU」页 → 在「关联的句柄」搜索框输入你的项目路径中的临时目录名，比如
abc123-temp - 若看到
explorer.exe、MsMpEng.exe（Defender）、PhpStorm64.exe或Code.exe正在持有该路径下的.dll、.php或文件夹句柄，就确认是它们锁住了
临时绕过：强制跳过 rename，改用 copy + unlink
Composer 本身不提供开关，但可通过环境变量启用更保守的安装策略：
windows-auto
下载
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
- 运行前设置：
COMPOSER_HOME不必动，关键是加COMPOSER_NO_INTERACTION=1和COMPOSER_DISABLE_XDEBUG_WARN=1（非必须，但减少干扰） - 真正起作用的是：
COMPOSER_PROCESS_TIMEOUT=300（避免超时中断） + 启用回退模式：COMPOSER_ALLOW_SUPERUSER=1（部分旧版需要，新版已默认允许） - 但最直接有效的是：在项目根目录执行
composer install --prefer-dist --no-cache，跳过本地缓存可减少临时文件复用带来的锁冲突 - 如果仍失败，手动删掉
vendor/composer/下所有*-temp目录，再重试——别怕，Composer 会重建
长期缓解：关掉 Windows 的自动索引和实时防护
这不是“禁用杀软”，而是调整行为范围，对开发体验提升明显：
- 关 Windows Search 索引：打开「索引选项」→ 「修改」→ 取消勾选你的项目所在磁盘或具体项目文件夹（如
C:\dev\myproject） - 关 Microsoft Defender 实时扫描的例外：设置 → 更新与安全 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 添加或删除排除项 → 添加你的整个项目根目录（如
C:\dev\myproject） - VS Code 用户：检查设置里是否启用了
files.useExperimentalFileWatcher，建议设为false；同时禁用「文件资源管理器」预览窗格（查看 → 显示 → 取消勾选「预览窗格」） - PHPStorm 用户：设置 → 目录 → 将
vendor/标记为「Excluded」，避免其后台扫描 .php 文件
临时目录重命名失败的本质，是 Windows 文件系统对“正在使用的目录”不允许原子移动。跨平台方案不存在——Linux 的 rename() 本身支持覆盖，而 Windows 必须先清空目标再移动，中间一旦有进程打开任意子文件，就卡死。所以别指望 Composer 改逻辑，重点得管住那些默默伸手的进程。
