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

个人资料偏好设置

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

您可以更新偏好设置来改变 GitLab 的外观和感觉。

更改模式

您可以更改界面的颜色模式,设置为浅色、深色或根据设备偏好自动更新。

要更改外观:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. Mode 部分,选择一个选项。
  4. 选择 Save changes

更改导航主题

您可以更改 GitLab UI 的导航主题。这些颜色显示在左侧边栏。 使用单独的导航主题可以帮助您区分不同的 GitLab 实例。

要更改导航主题:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. Navigation 部分,选择一个主题。

更改语法高亮主题

语法高亮是代码编辑器和 IDE 中的功能。高亮器为每种类型的代码分配颜色,例如字符串和注释。

要更改语法高亮主题:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. Syntax highlighting 部分,选择一个主题。
  4. 选择 Save changes

要查看更新的语法高亮主题,请刷新您的项目页面。

您还可以 使用应用程序设置 API 来自定义语法高亮主题。使用 default_syntax_highlighting_themedefault_dark_syntax_highlighting_theme 来更精细地更改语法高亮颜色。

如果这些步骤不起作用,您的编程语言可能不被语法高亮器支持。 有关更多信息,请查看 Rouge Ruby Library 了解代码文件和代码片段的指导。查看 Monaco EditorMonarch 了解 Web IDE 的指导。

更改差异颜色

差异使用两种不同的背景颜色来显示代码版本之间的更改。默认情况下,原始文件为红色,更改部分为绿色。

要更改差异颜色:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Diffs 部分。
  4. 选择一种颜色或输入颜色代码。
  5. 选择 Save changes

要恢复默认颜色,清除 Color for removed linesColor for added lines 文本框,然后选择 Save changes

行为

使用 Behavior 部分来自定义系统布局和默认视图的行为。您可以更改布局宽度,并选择主页、组和项目概述页面的默认内容。您有自定义外观和功能的选项,如空白字符渲染、文件显示和文本自动化。

更改 UI 上的布局宽度

您可以拉伸 GitLab UI 上的内容以填满整个页面。默认情况下,页面内容固定为 1280 像素宽。

要更改 UI 的布局宽度:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. Layout width 下,选择 FixedFluid
  5. 选择 Save changes

设置默认文本编辑器

默认情况下,所有新用户在编辑内容时都会看到 Rich text editor。 您可以更改在 GitLab 中编辑内容的默认编辑器。

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. Default text editor 下,确保选中 Enable default text editor 复选框。
  5. 选择 Rich text editorPlain text editor 作为您的默认编辑器。
  6. 选择 Save changes

选择您的主页

控制您选择 GitLab logo ( tanuki ) 时查看的页面。您可以将主页设置为您的贡献项目(默认)、您的组、您的活动和其他内容。

要选择您的主页视图:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. Homepage 下拉列表中,选择一个选项。
  5. 选择 Save changes

自定义组概述页面的默认内容

您可以更改组概述页面的主要内容。您的组概述页面是您在左侧边栏选择 Groups 时显示的页面。您可以将组概述页面的默认内容自定义为:

  • 详情仪表板(默认),包括组活动和项目的概述。
  • 安全仪表板,可能包括组安全策略和其他安全主题。

有关更多信息,请查看 Groups

要更改组概述页面的默认内容:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. Group overview content 下拉列表中,选择一个选项。
  5. 选择 Save changes

自定义项目概述页面的默认内容

您的项目概述页面是您在左侧边栏选择 Project overview 时查看的页面。您可以将主项目概述页面设置为活动页面、README 文件和其他内容。

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. Project overview content 下拉列表中,选择一个选项。
  5. 选择 Save changes

隐藏快捷按钮

快捷按钮位于项目概述页面的文件列表之前。这些按钮提供到项目各部分的链接,如 README 文件或许可协议。

要隐藏项目概述页面上的快捷按钮:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 清除 Show shortcut buttons above files on project overview 复选框。
  5. 选择 Save changes

在 Web IDE 中显示空白字符

空白字符是文本中的任何空白字符,如空格和缩进。您可能使用空白字符来结构化代码内容。如果您的编程语言对空白字符敏感,Web IDE 可以检测到它们的变化。

要在 Web IDE 中渲染空白字符:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Render whitespace characters in the Web IDE 复选框。
  5. 选择 Save changes

您可以在差异中查看空白字符的变化。

要在 Web IDE 中查看差异,请按照以下步骤操作:

  1. 在左侧边栏,选择 Source Control ( branch )。
  2. Changes 选项卡下,选择您的文件。

在差异中显示空白字符更改

查看差异文件中空白字符的更改。有关空白字符的更多信息,请查看之前的任务。

要在差异中查看空白字符的更改:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Show whitespace changes in diffs 复选框。
  5. 选择 Save changes

有关差异的更多信息,请查看 更改差异颜色

在合并请求中每页显示一个文件

Changes 选项卡允许您在一个页面上查看合并请求中的所有文件更改。 相反,您可以选择一次查看一个文件。

要在 Changes 选项卡上每页显示一个文件:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Show one file at a time on merge request’s Changes tab 复选框。
  5. 选择 Save changes

然后,要在 Changes 选项卡上在不同文件之间移动,在每个文件下方,选择 PreviousNext 按钮。

自动包围字符

当您输入开始字符时,自动为文本添加相应的结束字符。例如,当您输入开始括号时,可以自动插入结束括号。此设置仅在描述和评论框中有效,适用于以下字符:**", ', ```, (, [, {, <, *, _**

要在描述和评论框中自动包围字符:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Surround text selection when typing quotes or brackets 复选框。
  5. 选择 Save changes

在描述或评论框中,您现在可以输入一个单词,高亮它,然后输入一个开始字符。系统不会替换文本,而是在末尾添加结束字符。

自动创建新列表项

在描述和评论框的列表中按 Enter> 时创建新列表项。

要在按 Enter> 键时添加新列表项:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Automatically add new list items 复选框。
  5. 选择 Save changes

保持光标缩进

Enter> 时保持缩进。新行上的光标会自动与上一行相同的缩进。此设置仅在描述和评论框中有效。

要在按 Enter> 键时添加新列表项:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 选择 Maintain cursor indentation 复选框。
  5. 选择 Save changes

更改制表符宽度

更改差异、blob 和代码片段中制表符的默认大小。Web IDE、文件编辑器和 Markdown 编辑器不支持此功能。

要调整默认制表符宽度:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 滚动到 Behavior 部分。
  4. 对于 Tab width,输入一个值。
  5. 选择 Save changes

本地化

更改本地化设置,如您的语言、日历开始日期和时间偏好。

更改 GitLab UI 上的显示语言

GitLab 在 UI 上支持多种语言。

要为 GitLab UI 选择语言:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Localization 部分。
  4. Language 下,选择一个选项。
  5. 选择 Save changes

您可能需要刷新页面才能查看更新的语言。

自定义您的贡献日历开始日期

选择贡献日历从一周中的哪一天开始。贡献日历显示过去一年的项目贡献。您可以在每个用户资料上查看此日历。要访问您的用户资料:

  • 在左侧边栏,选择您的头像 > 选择您的姓名或用户名。

要更改您的贡献日历开始日期:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Localization 部分。
  4. First day of the week 下,选择一个选项。
  5. 选择 Save changes

更改日历开始日期后,请刷新您的用户资料页面。

显示精确时间而不是相对时间

自定义在您的组和项目概述页面以及用户资料上显示活动时间的格式。您可以以以下格式显示时间:

  • 相对格式,例如 30 minutes ago
  • 绝对格式,例如 September 3, 2022, 3:57 PM

要在 GitLab UI 上使用精确时间:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Time preferences 部分。
  4. 清除 Use relative times 复选框。
  5. 选择 Save changes

自定义时间格式

您可以自定义在您的组和项目概述页面以及用户资料上显示活动时间的格式。您可以将时间显示为:

  • 12 小时格式。例如:2:34 PM
  • 24 小时格式。例如:14:34

您也可以遵循系统的设置。

要自定义时间格式:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Time preferences 部分。
  4. Time format 下,选择 System12-hour24-hour 选项。
  5. 选择 Save changes

禁用精确代码搜索(已弃用)

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed
  • Status: Beta

此功能在 GitLab 18.3 中 已弃用 并计划在 18.6 中移除。

此功能处于 beta 阶段,可能会随时更改。 有关更多信息,请查看 epic 9404

先决条件:

要在用户偏好设置中禁用 精确代码搜索

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Exact code search 部分。
  4. 清除 Enable exact code search 复选框。
  5. 选择 Save changes

CI 作业 JSON Web 令牌中的用户身份

CI/CD 作业生成 JSON Web 令牌,其中可以包含您的外部身份列表。 您无需进行单独的 API 调用来获取各个账户,就可以在单个身份验证令牌中找到您的用户身份。

外部身份默认不包含。 要启用包含外部身份,请查看 令牌负载

控制关注者互动

关闭其他 GitLab 用户关注或被关注的能力。默认情况下,您的用户资料,包括您的姓名和个人资料照片,在其他用户的 Following 选项卡中是公开的。当您停用此设置时:

  • GitLab 会删除您的所有关注者和被关注连接。
  • GitLab 会自动从每个连接的页面中移除您的用户资料。

要移除被其他用户关注和关注其他用户的能力:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 清除 Enable follow users 复选框。
  4. 选择 Save changes

要访问您的 FollowersFollowing 选项卡:

  • 在左侧边栏,选择您的头像 > 选择您的姓名或用户名。
  • 选择 FollowersFollowing

将您的 GitLab 实例与第三方服务集成

让第三方服务访问权限以增强 GitLab 体验。

将您的 GitLab 实例与 Gitpod 集成

当您想要直接从 GitLab 浏览器启动和管理代码时,将您的 GitLab 实例与 Gitpod 配置。Gitpod 会自动为您的项目准备和构建开发环境。

要与 Gitpod 集成:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 找到 Integrations 部分。
  4. 选择 Enable Gitpod integration 复选框。
  5. 选择 Save changes

将您的 GitLab 实例与 Sourcegraph 集成

GitLab 支持 GitLab 上所有公共项目的 Sourcegraph 集成。

要与 Sourcegraph 集成:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 找到 Integrations 部分。
  4. 选择 Enable integrated code intelligence on code views 复选框。
  5. 选择 Save changes

您必须是 GitLab 实例的 Admin 才能配置 GitLab 与 Sourcegraph 的集成。

与扩展市场集成

  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

您可以使用扩展市场来搜索和 管理扩展 用于 Web IDEworkspaces。 对于第三方扩展,您必须在用户偏好设置中启用市场。

先决条件:

要为 Web IDE 和工作空间启用扩展市场:

  1. 在左侧边栏,选择您的头像。
  2. 选择 Preferences
  3. 转到 Integrations 部分。
  4. 选择 Enable extension marketplace 复选框。
  5. 在第三方扩展确认中,选择 I understand
  6. 选择 Save changes