在控制台中管理仓库文件

概述

代码托管服务提供了对文件的编辑、追溯、对比等功能。

当您进入仓库详情控制台中，系统将为您定位到“文件”页签，在这里您可以切换到不同的分支、标签，查看对应版本中文件的情况，其页面左侧（下图左）为文件列表，右侧（下图右）为可切换的标签：仓库名称（显示为当前所展示的文件的名称）、历史。

文件列表

文件列表位于该仓库详情中的文件页签的左侧。

文件列表包含以下功能：

• 切换分支、标签：切换后的分支、标签后会显示对应版本的文件目录。

  

• 单击检索：单击弹出搜索页面，可对文件列表进行搜索定位。
• 单击可扩展功能如下：
  • 新建文件。
  • 新建目录。
  • 新建子模块。
  • 上传文件。
• 鼠标停留在文件名称处，可以显示修改文件名称的按钮。
• 单击文件名称可将该文件内容显示于页面右侧的“仓库名称”页签，在“仓库名称”页签可对文件进行修改文件内容、追溯文件修改记录等操作。
  

  ：文件。

  ：文件夹。

  ：子模块(Git Submodule)。

新建文件

在代码托管仓库控制台新建文件，等同于“文件的新建 → add → commit→ push”操作，会生成提交记录。

新建的文件会添加对应分支的文件列表，并可以在“仓库名称”页签中查看其提交备注、详细内容等。

步骤如下：

1. 进入代码托管服务仓库列表页。
2. 进入您的仓库。（如何新建仓库？）
3. 单击分支后的图标，在展开项中选择“新建文件”，弹出“新建文件”页面（注意本步骤是在分支下新建文件）。

   单击文件夹右侧的图标，在展开项中选择“新建文件”，弹出“新建文件”页面（注意本步骤是在分支的文件夹下新建文件）。

4. 在“新建文件”页面，按提示填选相关内容。

   “备注”字段相当于git commit中的-m消息，可以用于关联工作项。

5. 单击“确定”按钮，即可保存新建的文件。

新建目录

在代码托管仓库控制台新建目录，其实是一次“文件夹结构的新建 → add → commit→ push”，会生成提交记录。

新建的目录结构（文件夹结构）会添加对应分支的文件列表，并可以在“仓库名称”页签中查看其每层的提交备注、详细内容等。

新建目录后在目录的最深层会默认新建一个.gitkeep文件，这是因为Git不允许提交空文件夹。

步骤如下：

1. 进入代码托管服务仓库列表页。
2. 进入您的仓库。（如何新建仓库？）
3. 单击分支后的图标，在展开项中选择“新建目录”，弹出“新建目录”页面（注意本步骤是在分支下新建目录）。

   单击文件夹右侧的图标，在展开项中选择“新建目录”，弹出“新建目录”页面（注意本步骤是在分支的文件夹下新建目录）。

4. 在“新建目录”页面，按提示填选相关内容。
   • 目录用“/” 划分层级。
   • “备注”字段相当于git commit中的-m消息，可以用于关联工作项。

5. 单击“确定”按钮，即可保存新建目录结构。

上传文件

在代码托管仓库控制台上传文件，其实是一次“文件的新建 → add → commit→ push”，会生成提交记录。

步骤如下：

1. 进入代码托管服务仓库列表页。
2. 进入您的仓库。（如何新建仓库？）
3. 单击分支后的图标，在展开项中选择“上传文件”，弹出“上传文件”页面（注意本步骤是在分支下上传文件）。

   单击文件夹右侧的图标，在展开项中选择“上传文件”，弹出“上传文件”页面（注意本步骤是在分支的文件夹下上传文件）。

4. 在“上传文件”页面，按提示填选相关内容。
   • 支持所有文件格式，每次只能上传单个文件，浏览器上传单个文件不超过10M，如果超过10M，请使用Git客户端push方式上传（客户端支持10M以上文件的上传）。
   • “备注”字段相当于git commit中的-m消息，可以用于关联工作项。

5. 单击“确定”按钮，即可完成文件上传。

上传的文件会添加对应分支的文件列表，并可以在“仓库名称”页签中查看其每层的提交备注、详细内容等。

修改文件名称

在代码托管仓库控制台修改文件名称，其实是一次“文件的名称修改 → add → commit→ push”，会生成提交记录。

步骤如下：

1. 进入代码托管服务仓库列表页。
2. 进入您的仓库。（如何新建仓库？）
3. 鼠标悬停于左侧文件列表中的某个文件上，单击显示的图标，弹出“修改文件名”页面。
4. 在“修改文件名”页面，修改文件名称、填写备注内容。

   “备注”字段相当于git commit中的-m消息，可以用于关联工作项。

5. 单击“确定”按钮，即可完成文件名称的修改操作。

仓库名称页签：查看仓库详细内容

“仓库名称”页签位于仓库详情中，其默认状态显示仓库详情列表，如下图所示。

其中包含字段：

• 文件：文件或文件夹的名称，
• 更新时间：此文件或文件夹的上次更新时间。
• 创建者：此文件或文件夹的上次提交创建者。
• 备注：此文件或文件夹的上次提交备注（commit的-m），单击可定位到此次提交记录。

编辑、删除操作需要填写备注信息，相当于git commit中的-m消息，其可以用于关联工作项。

历史页签（仓库）：查看仓库的提交历史

“历史”页签位于仓库详情中，其显示该仓库的提交历史，如下图所示。

在这个页面，可以对提交历史做如下操作：

• 单击“提交记录名称”，可以跳转到该次提交的详情中。
• 可点开扩展功能：
  • 新建分支。
  • 新建标签：可针对此次提交补打标签。（什么是标签？）
  • Cherry-Pick：把此次提交作为最新的提交覆盖到某条分支上，这是一种版本找回方式。
  • Revert：还原此次提交。
  • 提交记录：查看提交记录。

文件名称页签：查看文件详细内容

“文件名称”页签位于文件详情中，其默认状态显示文件详情内容，如下图所示。

历史页签（文件）：查看文件的提交历史

“历史”页签位于文件详情中，其显示该文件的提交历史，如下图所示。

在这个页面，可以对提交历史做如下操作：

• 单击“提交记录名称”，可以跳转到该次提交的详情中。
• 可点开扩展功能：
  • 新建分支。
  • 新建标签：可针对此次提交补打标签。（什么是标签？）
  • Cherry-Pick：把此次提交作为最新的提交覆盖到某条分支上，这是一种版本找回方式。
  • Revert：还原此次提交。
  • 提交记录：查看提交记录。

修改追溯页签：查看仓库文件的修改历史并追溯

“修改追溯”页签位于文件详情中，单击目标文件，显示如下图所示。

在这个页面，修改者与修改内容相互对应，单击提交信息名称可以跳转到该次提交的详情中。

对比页签：提交的差异对比

“对比”页签位于文件详情中，单击目标文件，显示如下图所示，左右文本框内，可以选择不同提交批次，进行差异对比。

在代码托管控制台对比出的差异，其展现形式优于Git Bash客户端。

本服务中的差异对比，其对比结果其实是显示您从左侧仓库版本向右侧仓库版本合并时对右侧仓库内文件所产生的影响，所以如果您想全面了解两个文件版本的差异，可以调整左右位置后再次对比，结合两次结果了解全部差异。