文件锁定

文件锁定可以防止多人同时编辑同一个文件，从而帮助避免合并冲突。文件锁定对于无法合并的二进制文件（如设计文件、视频和其他非文本内容）特别有价值。

GitLab 支持两种不同类型的文件锁定：

• 独占文件锁定：通过 Git LFS 和 .gitattributes 在命令行应用。这些锁定会阻止在任何分支上修改被锁定的文件。
• 默认分支文件和目录锁定：通过 GitLab UI 应用。这些锁定仅阻止在默认分支上修改文件和目录。

权限

您必须拥有项目的至少 Developer 角色，才能创建、查看或管理文件锁定。更多信息，请参见 角色和权限。

默认分支文件和目录锁定

默认分支锁定仅适用于您项目设置中的 默认分支。这些锁定有助于保持默认分支的稳定性，同时不会阻塞其他分支中的协作者工作流程。

当用户锁定文件或目录时：

• 只有创建锁定的用户才能在默认分支上修改该文件或目录。
• 对于其他用户，被锁定的文件或目录在默认分支上为只读。
• 在默认分支上直接修改被锁定的文件或目录是被阻止的。
• 修改被锁定文件或目录的合并请求无法合并到默认分支。

锁定文件或目录

前提条件：

• 您必须拥有项目的至少 Developer 角色。

要锁定文件或目录：

1. 在左侧边栏，选择 搜索或跳转 并找到您的项目。
2. 转到您要锁定的文件或目录。
3. 在右上角，选择 锁定。
4. 在确认对话框中，选择 确定。

如果 锁定 未启用，则您没有锁定该文件所需的权限。

要查看锁定目录的用户（如果不是您自己），请将鼠标悬停在按钮上。有关为锁定文件恢复类似功能的讨论，请参见 问题 376222。

从操作菜单进行文件操作

要锁定文件：

1. 在左侧边栏，选择 搜索或跳转 并找到您的项目。
2. 转到您要锁定的文件。
3. 在右上角，文件名旁边，选择 操作 ( ) > 锁定。
4. 在确认对话框中，选择 确定。

如果您没有权限锁定文件，则菜单项将被禁用。

查看被锁定的文件

前提条件：

• 您必须拥有项目的至少 Developer 角色。

要查看被锁定的文件：

1. 在左侧边栏，选择 搜索或跳转 并找到您的项目。
2. 选择 代码 > 被锁定的文件。

被锁定的文件 页面显示所有使用 Git LFS 独占锁定或 GitLab UI 锁定的文件。

移除文件锁定

前提条件：

• 您必须满足以下条件之一：
  • 是创建锁定的用户。
  • 拥有项目的至少 Maintainer 角色。

要移除锁定：

相关主题

• 使用 Git 进行文件管理
• 文件锁定