文件管理

极狐GitLab 用户界面扩展了 Git 的历史记录和跟踪功能，通过浏览器提供用户友好的功能。您可以：

• 搜索文件。
• 更改文件处理。
• 探索整个文件或单个行的历史记录。

理解文件类型在用户界面中的渲染方式#

当您将这些类型的文件添加到项目中时，极狐GitLab 会渲染它们的输出以提高可读性：

• GeoJSON 文件显示为地图。
• Jupyter Notebook 文件显示为渲染的 HTML。
• 多种标记语言的文件被渲染以供显示。

支持的标记语言#

如果您的文件具有这些文件扩展名之一，极狐GitLab 会在用户界面中渲染文件的标记语言的内容。

README 和 index 文件#

当仓库中存在 README 或 index 文件时，极狐GitLab 会渲染其内容。这些文件可以是纯文本或具有支持的标记语言扩展名。

• 当同时存在 README 和 index 文件时，README 优先。

• 当多个具有相同名称的文件具有不同扩展名时，文件按字母顺序排序。极狐GitLab 将没有扩展名的文件排在最后，如下所示：

  1. README.adoc
  2. README.md
  3. README.rst
  4. README.

渲染 OpenAPI 文件#

极狐GitLab 会渲染 OpenAPI 规范文件，如果文件名包含 openapi 或 swagger，且扩展名为 yaml、yml 或 json。这些示例都是正确的：

• openapi.yml, openapi.yaml, openapi.json
• swagger.yml, swagger.yaml, swagger.json
• OpenAPI.YML, openapi.Yaml, openapi.JSON
• openapi_gitlab.yml, openapi.gitlab.yml
• gitlab_swagger.yml
• gitlab.openapi.yml

要渲染 OpenAPI 文件：

1. 搜索仓库中的 OpenAPI 文件。
2. 选择 显示渲染文件。
3. 要在操作列表中显示 operationId，请在查询字符串中添加 displayOperationId=true。

查看文件的 Git 记录#

您的仓库中的文件的历史信息在极狐GitLab 用户界面中可用：

• Git 文件历史：显示整个文件的提交历史。
• Git 责任：显示基于文本的文件的每一行，以及最近更改该行的提交。

查看文件的开放合并请求#

在查看仓库中的文件时，极狐GitLab 会显示一个徽章，指示针对当前分支并修改文件的开放合并请求数量。这有助于您识别有待处理更改的文件。

要查看文件的开放合并请求：

1. 在左侧侧边栏，选择 搜索或转到 并找到您的项目。
2. 转到您要查看的文件。
3. 在屏幕右上角，文件名旁边，查找带有
   开放 合并请求数量的绿色徽章。
4. 选择徽章以查看过去 30 天内创建的开放合并请求列表。
5. 在列表中选择任何合并请求以转到该合并请求。

搜索文件#

使用文件查找器直接从极狐GitLab 用户界面搜索仓库中的文件。文件查找器使用模糊搜索并在您键入时突出显示结果。

要搜索文件，请在项目中的任何地方按 t，或者：

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

2. 选择 代码 > 仓库。

3. 在右上角，选择 查找文件。

4. 在对话框中开始输入文件名：

   

5. 可选。要缩小搜索选项，请按 Command + K 或选择 命令 在对话框的右下角：

   • 对于 页面或操作，输入 >。
   • 对于 用户，输入 @。
   • 对于 项目，输入 :。
   • 对于 文件，输入 ~。

6. 从下拉列表中选择文件以在您的仓库中查看它。

要返回到 文件 页面，按 Esc。

此功能使用 fuzzaldrin-plus 库。

更改 Git 处理文件的方式#

要更改文件或文件类型的默认处理方式，请创建一个.gitattributes 文件。使用 .gitattributes 文件来：

• 配置差异中的文件显示，如语法高亮或折叠生成的文件。
• 控制文件存储和保护，如使文件只读或使用 Git LFS 存储大文件。

相关主题#

• 仓库文件 API
• 使用 Git 进行文件管理

疑难解答#

仓库语言：过度 CPU 使用#

为了确定仓库文件中的语言，极狐GitLab 使用 Ruby gem。当 gem 解析文件以确定其文件类型时，该过程可能会使用过多的 CPU。gem 包含一个启发式配置文件，定义了要解析的文件扩展名。这些文件类型可能会占用过多的 CPU：

• 具有 .txt 扩展名的文件。
• 扩展名未定义的 XML 文件。

要解决此问题，请编辑您的 .gitattributes 文件并为特定文件扩展名指定语言。您还可以使用这种方法来修复识别错误的文件类型：

1. 确定要指定的语言。gem 包含一个已知数据类型的配置文件。

2. 要为文本文件添加条目，例如：

   yaml
   1Text:
   2  type: prose
   3  wrap: true
   4  aliases:
   5  - fundamental
   6  - plain text
   7  extensions:
   8  - ".txt"

3. 在仓库的根目录中添加或编辑 .gitattributes：

   plaintext
   *.txt linguist-language=Text

*.txt 文件在启发式文件中有一个条目。此示例防止解析这些文件。