Git合并提示“文件被锁定”并非Git自身锁文件，而是Windows资源管理器、IDE或杀毒软件等外部工具占用文件句柄导致系统拒绝访问；需关闭相关进程或禁用实时扫描等操作释放锁。

为什么 Git 合并时会提示“文件被锁定” Git 本身不锁文件，这个错误几乎都来自外部工具——最常见的是 Windows 上的文件资源管理器、IDE（如 VS Code、JetBrains 系列）、或杀毒软件在后台占用文件句柄。当你执行 git merge 时，Git 尝试覆盖或重写工作区文件，但系统拒绝访问，于是抛出类似 Unable to create file xxx: Permission denied 或 Failed to update ref refs/heads/xxx: unable to write sha1 filename 的提示，部分 GUI 工具则直接显示“文件被锁定”。

关键判断：不是 Git 的 bug，也不是分支冲突，而是操作系统级的文件占用问题。

Cnb Cool Git

CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。

下载

如何快速定位并释放被锁定的文件 先确认具体哪个文件卡住，Git 报错里一般会带路径，比如 .git/index 或 src/main.ts。然后分场景处理：

• VS Code 打开着对应文件或整个项目？关闭编辑器再试；如果必须开着，检查是否启用了 files.autoSave 或 files.hotExit，临时关掉
• Windows 资源管理器正预览该文件（尤其是 .dll、.exe、图片）？关闭所有资源管理器窗口，或进任务管理器结束 explorer.exe 进程后重启
• 杀毒软件（如 Windows Defender 实时扫描）正在扫描工作目录？临时禁用实时保护，或把项目目录加到排除列表
• 有其他进程（如 Webpack dev server、Python 脚本、数据库客户端）在读写该文件？用 lsof -i（macOS/Linux）或 Process Explorer（Windows）查句柄

合并前预防文件锁定的实操习惯 Git 在 Windows 上对文件锁更敏感，尤其使用 NTFS + 长路径时。以下动作能大幅降低概率：

• 避免在 Git 工作目录里直接双击打开可执行文件或文档（.pdf/.xlsx 等），改用专用应用打开并关闭预览窗格
• IDE 中关闭“在资源管理器中显示”“预览模式”等自动触发文件访问的功能
• 执行 git merge 前，运行 git status 确认没有未提交变更；如果有，先 git add 或 git stash，减少文件重写量
• 考虑启用 Git 的 core.autocrlf 和 core.filemode 避免因换行符或权限误判引发额外文件操作

实在解不开锁时的绕过方案 不推荐跳过锁定检查，但紧急情况下可尝试：

• 切换到干净终端（如 Windows Terminal 而非 PowerShell ISE），以管理员身份运行，排除 shell 权限干扰
• 临时把 .git/index 重命名为 .git/index.bak，再运行 git read-tree --reset -u HEAD 重建索引（慎用，仅适用于无未暂存修改时）
• 用 git checkout -f 强制重置工作区，再重新 git merge；注意这会丢弃本地未提交改动
• 终极办法：克隆新副本，在新目录里 git merge，再复制必要修改回来

Git 不锁文件，但它对文件系统的调用很直接。所谓“被锁定”，其实是你在不知情时让别的程序攥住了文件。多数时候，关掉一个窗口、停掉一个进程，就解决了。真正麻烦的是那些静默占用句柄的后台服务——它们不会报错，只让你反复失败。