编译卡死多因文件锁阻塞，常见于Samba挂载、多进程共享构建目录或IDE保存冲突；解决需用cache=strict/noperm/uid-gid挂载参数、隔离构建目录、禁用编辑器原子保存，并优先将build目录移至本地。
编译卡死时先确认是不是文件锁在阻塞
编译过程卡在某个文件写入或链接阶段，光标不动、CPU 低、磁盘灯狂闪，strace -p $(pgrep -f 'gcc|clang|make') 显示卡在 renameat2() 或 flock() 系统调用上——这基本就是文件锁机制在作祟，不是编译器 bug，也不是磁盘慢。
常见诱因有三类：Samba/CIFS 挂载目录下编译、多进程并发写同一构建目录（如多个 make -j 实例争抢 build/）、或 IDE（如 Sublime Text、PhpStorm）后台保存行为与编译器同时操作中间文件。
- Linux 下
flock()和fcntl()锁是 advisory（建议性），但 GCC/Clang 在生成 .o 或链接时会依赖文件系统级原子操作（如 rename），而 CIFS/Samba 对 rename 的支持极不稳定 - Windows 共享默认禁用 SMB1，Ubuntu 22.04+ 默认用 SMBv3，但
vers=3.0不等于 rename 就可靠；Samba 服务端若未启用posix extensions = yes，客户端挂载再怎么调参也白搭 - 某些构建系统（如 Ninja）会主动对 build.ninja 加
flock，若锁文件残留（比如上次崩溃没释放），后续编译就会永久等待
挂载 Samba 共享时必须加的三个参数
不改服务端配置，只改客户端挂载命令就能解决 90% 的编译卡死。核心是绕过服务端 rename 限制 + 关闭内核权限校验：
-
cache=strict：强制内核缓存元数据，避免每次rename都发网络请求。缺省cache=none或cache=loose会导致大量 round-trip 延迟 -
noperm：跳过挂载点本地权限检查。否则chmod失败会让编译器误判为写入失败（尤其当服务端 uid 映射不一致时） -
uid=1000,gid=1000：显式指定属主。避免编译器以 root 启动（如 sudo make）却写不到普通用户权限的共享路径
完整挂载命令示例：sudo mount -t cifs //192.168.1.100/project /mnt/proj -o credentials=/etc/samba/cred,iocharset=utf8,cache=strict,noperm,uid=1000,gid=1000,vers=3.0
注意：vers=3.0 必须和服务端实际支持版本一致。Windows 10 1809+ 可用；Windows 7 或旧版 Samba 4.5 以下只能用 vers=2.0，且 rename 依然脆弱——这种情况下建议换成本地编译，再 rsync 同步。
构建目录必须隔离，禁止跨进程共享
多个终端同时执行 make -j 或 IDE 自动构建，如果共用同一个 build/ 目录，flock() 或临时文件重命名必然冲突。这不是锁“没设好”，而是设计上就不该共享。
- 每个构建上下文用独立目录：
mkdir build-debug && cd build-debug && cmake .. -DCMAKE_BUILD_TYPE=Debug - CI/CD 中用
mktemp -d动态生成构建路径，避免残留锁文件干扰 - 若必须复用构建目录（如嵌入式交叉编译频繁切换 toolchain），手动清理锁残留：
find build/ -name '.ninja_lock' -delete或rm -f build/CMakeCache.txt build/CMakeFiles/
Ninja 默认对 build.ninja 加锁，CMake 默认不加锁——但一旦你用 cmake --build build/ --parallel，它底层仍可能调用 Ninja，所以统一按 Ninja 规则处理最稳妥。
IDE 编辑器保存行为与编译器的冲突点
Sublime Text、PhpStorm 这类编辑器默认“先写 .tmp 文件，再 rename 替换原文件”，和 GCC 编译中间文件（如 foo.o）的原子写入逻辑完全撞车。尤其当源文件和目标文件在同一目录时，rename 竞争直接卡死。
- Sublime Text：关掉
atomic_save（设置里搜），改用直接写入模式；或确保项目不在 CIFS 挂载点——本地 SSD 编译，共享目录只放源码 - PhpStorm：禁用
safe write（Settings → Appearance & Behavior → System Settings → Synchronization），否则它会在保存时先写.php~再 rename - VS Code：检查
"files.autoSave": "afterDelay"是否触发频繁写，可设为"off"或改用" onFocusChange"减少干扰
最硬核但有效的办法：把构建输出目录（build/、out/）从共享目录移到本地路径，只让源码目录挂载——既保留协作便利，又避开所有文件锁雷区。
真正麻烦的从来不是锁本身，而是不同组件（内核、CIFS 驱动、编辑器、构建系统）对“原子性”的理解不一致。盯住 renameat2() 和 flock() 这两个系统调用，比调 IDE 设置管用十倍。
