Help us learn about your current experience with the documentation. Take the survey.

Web Editor

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

Web Editor 是一个基于浏览器的工具，无需本地设置即可对 GitLab 仓库进行更改。您可以：

  • 编辑单个文件并查看实时的 Markdown 预览。
  • 创建新文件和目录。
  • 上传和替换文件。
  • 创建分支和标签进行版本控制。
  • 锁定文件以防止并发编辑冲突。
  • 无需在本地设置 Git 即可参与项目。

GitLab 使用您的主邮箱地址进行 Web Editor 提交。

对于多个文件的更改，请使用Web IDE。

要管理受保护分支中的文件，您必须拥有相应的权限。

管理文件

您可以使用 Web Editor 直接从 GitLab UI 创建、编辑、上传和删除文件。

创建文件

要在 Web Editor 中创建文本文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要创建新文件的目录。

  3. 在目录名称旁边，选择加号图标 ( plus ) > 新建文件。

  4. 在分支名称旁边，输入文件名和扩展名。例如，my_file.md。

  5. 向文件中添加内容。

  6. 选择提交更改。

  7. 在提交消息字段中，输入提交原因。

  8. 选择以下选项之一：

    • 在预填充的目标分支中创建文件，选择提交更改。

    • 在新分支中创建文件并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 在新分支中创建文件、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。

从模板创建

要从模板在 Web Editor 中创建文本文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。
  2. 转到要创建新文件的目录。
  3. 在目录名称旁边，选择加号图标 ( plus ) > 新建文件。
  4. 在文件名中，输入 GitLab 提供模板的名称：
    • .gitignore
    • .gitlab-ci.yml
    • LICENSE
    • Dockerfile
  5. 从应用模板下拉列表中选择一个模板。
  6. 可选。根据需要更新模板。
  7. 继续执行创建文件过程中的第 6 步。

编辑文件

要在 Web Editor 中编辑文本文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要编辑的文件。

  3. 选择编辑 > 编辑单个文件。

  4. 进行您的更改。

  5. 选择提交更改。

  6. 在提交消息字段中，输入提交原因。

  7. 选择以下选项之一：

    • 从预填充的目标分支编辑文件，选择提交更改。

    • 从新分支编辑文件并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 从新分支编辑文件、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。
      5. 填写字段并选择创建合并请求。

如果有人在您编辑时编辑并提交了对同一文件的更改，您无法提交您的更改。将显示以下错误消息： 有人同时编辑了该文件。请检出文件并确保您的更改不会无意中删除他们的更改。

Markdown 预览

要在 Web Editor 中预览 Markdown 文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。
  2. 转到要预览的文件。
  3. 选择编辑 > 编辑单个文件。
  4. 选择预览选项卡。

您可以在内容旁边看到实时的 Markdown 预览。

要关闭预览面板，请选择编写选项卡。

链接到特定行

要在 Web Editor 中链接到单行或多行，请在 URL 的文件名部分添加哈希信息。例如：

  • MY_FILE.js#L3 突出显示 MY_FILE.js 中的第 3 行。
  • MY_FILE.js#L3-10 突出显示 MY_FILE.js 中的第 3 到 10 行。

编辑文件时，您也可以通过选择行号来链接到单行。

编辑分叉合并请求中的文件

先决条件：

如果您正在处理来自分叉项目的合并请求，可以编辑文件并提交更改。为此：

  1. 转到合并请求。
  2. 转到要编辑的文件。
  3. 选择编辑 > 编辑单个文件。
  4. 选择提交更改。
  5. 在提交消息中，输入提交原因。 提供以下信息：您的更改可以提交到 <branch-name>，因为存在打开的合并请求。
  6. 选择提交更改。

上传文件

要在 Web Editor 中上传文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要上传文件的目录。

  3. 在目录名称旁边，选择加号图标 ( plus ) > 上传文件。

  4. 拖放或上传您要添加的文件。

  5. 在提交消息字段中，输入提交原因。

  6. 选择以下选项之一：

    • 从预填充的目标分支上传文件，选择提交更改。

    • 从新分支上传文件并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 从新分支上传文件、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。
      5. 填写字段并选择创建合并请求。

删除文件

要在 Web Editor 中删除文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要删除的文件。

  3. 选择删除。

  4. 在提交消息中，输入提交原因。

  5. 选择以下选项之一：

    • 从预填充的目标分支删除文件，选择提交更改。

    • 从新分支删除文件并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 从新分支删除文件、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。

如果有人在您编辑时编辑并提交了对同一文件的更改，您无法提交您的更改。将显示以下错误消息： 有人同时编辑了该文件。请检出文件并确保您的更改不会无意中删除他们的更改。

替换文件

要在 Web Editor 中替换文件：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要替换的文件。

  3. 选择替换。

  4. 拖放或上传您要上传并替换现有文件的文件。

  5. 在提交消息中，输入提交原因。

  6. 选择以下选项之一：

    • 从预填充的目标分支替换文件，选择提交更改。

    • 从新分支替换文件并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 从新分支替换文件、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。

取消文件更改

要取消更改、编辑、上传或删除文件，从 Web Editor：

  1. 选择取消。

  2. 选择以下选项之一：

    • 确认要取消更改：选择确定。
    • 不要取消更改：选择取消。

从操作菜单进行文件操作

操作 ( ellipsis_v ) 菜单将文件操作合并到下拉列表中。从此菜单中，您可以：

  • 编辑文件。
  • 上传文件。
  • 删除文件。
  • 替换文件。

要完成这些操作：

  1. 在 GitLab 中打开文件。
  2. 在右上角，文件名旁边，选择操作 ( ellipsis_v )。
  3. 选择您需要的操作。

创建目录

要在 Web Editor 中创建目录：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。

  2. 转到要创建新目录的目录。

  3. 在目录名称旁边，选择加号图标 ( plus ) > 新建目录。

  4. 在目录名称字段中，输入您的目录名称。

  5. 在提交消息中，输入提交原因。

  6. 选择以下选项之一：

    • 从预填充的目标分支创建目录，选择提交更改。

    • 从新分支创建目录并提交更改：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框未选中。
      4. 选择提交更改。

    • 从新分支创建目录、提交更改并创建合并请求：

      1. 选择提交到新分支。
      2. 输入分支名称。
      3. 确保为此更改创建合并请求复选框已选中。
      4. 选择提交更改。

创建分支

要在 Web Editor 中创建分支：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。
  2. 在仓库名称旁边，选择加号图标 ( plus ) > 新建分支。
  3. 完成字段。
  4. 选择创建分支。

创建标签

您可以创建标签来标记里程碑，如生产版本和发布候选版本。要在 Web Editor 中创建标签：

  1. 在左侧边栏，选择搜索或跳转至并找到您的项目。
  2. 在仓库名称旁边，选择加号图标 ( plus ) > 新建标签。
  3. 完成字段。
  4. 选择创建标签。

相关主题