文件锁定报错主因是composer并发写vendor/或更新composer.lock时被系统级锁拦截，常见于windows、wsl2、nfs路径或多命令并行；本质非插件问题，而是flock()依赖的文件存在性、权限及文件系统posix支持三者任一缺失所致。
插件安装失败时的“文件锁定”报错，基本不是插件本身的问题，而是 Composer 正在并发写 vendor/ 或尝试覆盖 composer.lock 时被系统级锁拦截——常见于 Windows、WSL2、NFS 挂载路径，或多个命令同时运行。
为什么 install plugin 会触发文件锁失败
Composer 安装插件（如 composer require some/plugin）本质是执行一次完整依赖解析 + vendor 写入 + lock 文件更新。它会：
- 读取
composer.lock和composer.json，计算新依赖图 - 下载包并解压到
vendor/目录 - 最后尝试用
flock()锁住composer.lock再重写它
只要其中任意一步被阻断（文件不存在、权限不对、flock 不支持），就会报类似 Could not lock file ./composer.lock 或卡在 Writing lock file。这不是插件不兼容，而是锁机制没跑起来。
Windows / WSL2 下插件安装卡死的实操解法
Windows 和 WSL2 的 /mnt/c/ 路径默认不支持 POSIX flock()，这是最常被忽略的底层原因。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先验证：运行
df -T .，如果输出含ntfs或nfs，说明锁必然失效 - WSL2 用户：把项目移到
~/project/（Linux 原生路径），别放/mnt/c/Users/xxx/ - Windows 用户：改用 Git Bash 运行命令，它绕过 .bat 权限模型，不会触发 UAC 拦截
- 实在无法迁移路径：临时禁用防病毒软件（尤其是 Windows Defender 实时防护），它们常静默阻止 .bat 生成
并发场景下插件安装冲突的绕过方式
CI 或本地多终端同时执行 composer require，会导致多个进程争抢写 composer.lock 和 vendor/，哪怕加了 --no-interaction 也无效。
- 优先用平台原生锁：GitHub Actions 加
concurrency，GitLab CI 设interruptible: false - 退而求其次：用
flock .git -c 'composer require some/plugin'（前提是.git目录存在且可访问） - 彻底规避锁：先手动修改
composer.json，再运行composer install --no-plugins --no-scripts，最后单独启用插件
插件安装后文件被占用导致后续失败
某些插件（如 phpstan/extension-installer）会在 install 阶段自动注册 autoload 或执行脚本，导致 vendor/ 下文件被 PHP 进程或 IDE 持有句柄。
- 关闭所有 PHP 开发服务器（
php -S、Laravel Sail、Vite 等） - 退出 VS Code / PhpStorm，或禁用其 PHP 插件（尤其 “PHP Intelephense” 常后台扫描 vendor）
- Windows 下用资源监视器查占用进程；Linux/macOS 可试
lsof +D vendor/ - 必要时加
--no-scripts --no-plugins先完成基础安装，再分步启用
真正棘手的不是报错信息本身，而是它掩盖了锁机制的三层依赖：文件存在、权限正确、文件系统支持。跳过任意一层检查，都可能让问题在不同环境反复出现。
