Writing lock file卡住是因文件锁、权限或磁盘I/O问题，非网络或镜像所致；Composer此阶段仅做本地文件操作，需写权限、flock支持及无进程占用composer.lock或vendor/目录。
“Writing lock file”卡住不是镜像问题，而是 Composer 正在写入时被阻塞——90% 情况下根本没走到网络请求阶段，换镜像无效，得看文件系统、权限或锁文件冲突。
为什么Writing lock file会卡住
这个阶段不发 HTTP 请求，只做本地文件操作：生成 composer.lock 内容、校验哈希、原子写入。卡住说明磁盘 I/O、文件锁或权限出了问题，和镜像配置完全无关。
- 常见现象：终端停在
Writing lock file后无响应，Ctrl+C也无反应 - 真实原因可能是：
vendor/目录被其他进程（IDE 索引、杀毒软件、Git GUI）占用；Windows 下composer.lock被记事本或 VS Code 锁定；Docker 容器内挂载卷权限不足 - 别急着改
repositories或清缓存——这些对写文件没影响
composer.lock 文件被占用的快速排查
先确认是不是文件被锁死，而不是 Composer 自身 bug。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS：运行
lsof +D .（当前目录），看是否有进程在读写composer.lock或vendor/ - Windows：用
Process Explorer搜索composer.lock，或命令行执行handle -p php.exe | findstr lock - IDE 用户：关闭 PHPStorm 的 “Synchronize files on save”、VS Code 的 “Auto Save” 和 “Files: Auto Save Delay”，再试
- Docker 场景：检查 volume 挂载是否用了
:ro（只读），或宿主机文件权限是否导致容器内无法flock()
权限与文件系统导致的静默卡死
Composer 写 composer.lock 需要：当前用户对项目根目录有写权限、能创建硬链接（Linux/macOS）、能获取文件锁（所有平台）。任一失败都会卡在 Writing lock file。
- 常见错误：
Permission denied不一定报错，有时直接卡住——尤其在 WSL2 或 Docker 中，/mnt/c/下的 NTFS 卷不支持flock() - 验证方式：手动执行
touch composer.lock.test && rm composer.lock.test，失败即说明权限/文件系统有问题 - 临时解法：把项目移到 Linux 原生路径（如
~/project），或 Docker 中用tmpfs挂载/app - 别用
sudo composer install——它会生成 root 权限的vendor/，后续普通用户操作全卡住
CI/CD 流水线中Writing lock file卡住的特殊处理
GitHub Actions / GitLab CI 默认环境常禁用文件锁或限制 I/O，导致写 lock 文件超时，不是配置问题，是运行时约束。
- 必须加参数绕过原子写入：
composer install --no-interaction --no-cache --ignore-platform-reqs - 关键选项：
--no-cache防止缓存目录争抢锁；--ignore-platform-reqs避免因 platform mismatch 触发额外依赖解析（延长写入时间） - 如果仍卡，说明 runner 磁盘满或 inode 耗尽：加一步检查
df -h && df -i - 不要在 CI 中执行
composer update——它必然触发Writing lock file，应只用install还原已提交的 lock
真正卡在 Writing lock file 时，镜像地址、缓存、DNS 全都不相关。最有效的动作是关掉 IDE、查进程锁、换文件系统路径——而不是重配 repositories.packagist.org。
