亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon 中管理源代码文件 CodeCatalyst
<a name="source-files"></a>

在 Amazon 中 CodeCatalyst，文件是一种受版本控制的独立信息，可供您和存储文件的源存储库和分支的其他用户使用。您可以使用目录结构来组织存储库文件。 CodeCatalyst自动跟踪对文件的每一次提交的更改。您可以在不同的存储库分支中存储文件的不同版本。

要在源存储库中添加或编辑多个文件，您可以使用 Git 客户端、开发环境或集成式开发环境（IDE）。要添加或编辑单个文件，您可以使用 CodeCatalyst 控制台。

**Topics**
+ [创建或添加文件](source-files-create.md)
+ [查看文件](source-files-view.md)
+ [查看文件更改历史记录](source-files-view-history.md)
+ [编辑文件](source-files-edit.md)
+ [重命名或删除文件](source-files-delete.md)

# 创建或添加文件
<a name="source-files-create"></a>

要创建文件并将其添加到源存储库，您可以使用 Amazon CodeCatalyst 控制台、开发环境、互联集成开发环境 (IDE) 或 Git 客户端。 CodeCatalyst 控制台包括用于创建文件的代码编辑器。使用该编辑器可方便地在存储库的某个分支中创建或编辑简单文件，如 README.md 文件。处理多个文件时，可以考虑[创建开发环境](devenvironment-create.md)。

**从源存储库创建开发环境**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在导航窗格中，选择**代码**，然后选择**源存储库**。

1. 选择要在其中处理代码的源存储库。

1. 选择**创建开发环境**。

1. 从下拉菜单中选择受支持的 IDE。请参阅[开发环境支持的集成式开发环境](devenvironment-create.md#devenvironment-supported-ide)了解更多信息。

1. 请执行以下操作之一：
   + 选择**在现有分支中工作**，然后从**现有分支**下拉菜单中选择一个分支。
   + 选择**在新分支中工作**，在**分支名称**字段中输入分支名称，然后从**创建分支的来源**下拉菜单中选择要从中创建新分支的分支。

1. 还可选择为开发环境添加名称或编辑其配置。

1. 选择**创建**。

**在 CodeCatalyst 控制台中创建文件**

1. 导航到要在其中创建文件的项目。有关如何导航到存储库的更多信息，请参阅[查看源存储库](source-repositories-view.md)。

1. 从项目的源存储库列表中选择存储库的名称。或者，在导航窗格中，选择**代码**，然后选择**源存储库**。

   选择要在其中创建文件的存储库。

1. （可选）如果要在不同于默认分支的分支中创建文件，请选择要在其中创建文件的分支。

1. 选择**创建文件**。

1. 在**文件名**中输入文件的名称。在编辑器中添加文件内容。
**提示**  
如果要在分支根目录的子文件夹或子目录中创建文件，请将该结构作为文件名的一部分。

   对更改感到满意后，选择**提交**。

1. 在**文件名**中，查看文件名并根据需要进行更改。（可选）在**分支**中，从可用的分支列表中选择要在其中创建文件的分支。在**提交消息**中，可选择输入简短但翔实的描述，说明做出此更改的原因。这将显示为将文件添加到源存储库的提交的基本提交信息。

1. 选择**提交**，提交并将文件推送到源存储库。

您还可以通过将源存储库克隆到本地计算机，然后使用 Git 客户端或互联集成式开发环境（IDE）来推送文件和更改，从而将文件添加到源存储库中。

**注意**  
如果要添加 Git 子模块，您必须使用 Git 客户端或开发环境并运行 **git submodule add** 命令。您无法在 CodeCatalyst 控制台中添加或查看 Git 子模块，也无法在拉取请求中查看 Git 子模块的差异。有关 Git 子模块的更多信息，请参阅 [Git 文档](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。<a name="source-files-add-git"></a>

**使用 Git 客户端或互联集成式开发环境（IDE）添加文件**

1. 将源存储库克隆到本地计算机。有关更多信息，请参阅 [克隆源存储库](source-repositories-clone.md)。

1. 在本地存储库中创建文件，或将文件复制到本地存储库中。

1. 执行以下操作之一，创建并推送提交：
   + 如果您使用的是 Git 客户端，请在终端或命令行下运行 **git add** 命令，指定要添加的文件的名称。或者，要添加所有已添加或更改的文件，请运行 **git add** 命令，然后加上单句点或双句点，以指示您是要包含当前目录级别的所有更改（单句点），还是要包含当前目录及所有子目录的所有更改（双句点）。要提交更改，请运行 **git commit -m** 命令并提供提交消息。要将您的更改推送到中的源存储库 CodeCatalyst，请运行**git push**。有关 Git 命令的更多信息，请参阅 Git 文档和[分支的 Git 命令](source-branches-git.md)。
   + 如果您使用的是开发环境或 IDE，请在 IDE 中创建文件和添加文件，然后提交并推送您的更改。有关更多信息，请参阅[使用开发环境编写和修改代码 CodeCatalyst使用开发环境编写和修改代码](devenvironment.md)或 IDE 文档。

# 查看文件
<a name="source-files-view"></a>

您可以在 Amazon CodeCatalyst 控制台中查看源存储库中的文件。您可以查看默认分支和任何其他分支中的文件。文件内容可能因您选择查看的分支而异。

**在 CodeCatalyst 控制台中查看文件**

1. 导航到要在其中查看文件的项目。有关更多信息，请参阅 [查看源存储库](source-repositories-view.md)。

1. 

   从项目的源存储库列表中选择存储库的名称。或者，在导航窗格中，选择**代码**，然后选择**源存储库**。

   选择要查看其中文件的存储库。

1. 此时将显示默认分支的文件和文件夹列表。文件用纸张图标表示，文件夹用文件夹图标表示。

1. 执行以下任一操作：
   + 要查看不同分支中的文件和文件夹，请从分支列表中选择该分支。
   + 要展开文件夹，请从列表中选择该文件夹。

1. 要查看特定文件的内容，请从列表中选择该文件。该文件的内容将显示在分支中。要查看不同分支中的文件内容，请从分支选择器中选择所需的分支。
**提示**  
查看文件内容时，可以从**查看文件**中选择其他文件进行查看。要编辑文件，请选择**编辑**。

您可以在控制台中查看多个文件。您还可以使用 Git 客户端或集成式开发环境（IDE），查看已克隆到本地计算机的文件。有关更多信息，请参阅 Git 客户端或 IDE 的文档。

**注意**  
您无法在 CodeCatalyst 控制台中查看 Git 子模块。有关 Git 子模块的更多信息，请参阅 [Git 文档](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。

# 查看文件更改历史记录
<a name="source-files-view-history"></a>

您可以在 Amazon CodeCatalyst 控制台中查看源存储库中文件的更改历史记录。这有助于您了解在选择查看文件历史记录的分支上，不同提交对文件所做的更改。例如，如果查看源存储库的 **main** 分支中 **readme.md** 文件的更改历史记录，就会看到该分支中包含该文件更改的提交的列表。

**注意**  
您无法在 CodeCatalyst 控制台中查看链接存储库中文件的历史记录。<a name="source-files-view-file-history-console"></a>

# 在 CodeCatalyst 控制台中查看文件的历史记录
<a name="source-files-view-file-history-console"></a>

1. 导航到要查看其中文件历史记录的项目。有关更多信息，请参阅 [查看源存储库](source-repositories-view.md)。

1. 从项目的源存储库列表中选择存储库的名称。或者，在导航窗格中，选择**代码**，然后选择**源存储库**。

1. 选择要在其中查看文件历史记录的存储库。选择要在其中查看文件历史记录的分支，然后从列表中选择文件。选择 **View history (查看历史记录)**。

1. 查看指定分支中包含对该文件更改的提交的列表。要查看特定提交中包含的更改详细信息，请在列表中选择该提交的提交消息。此时显示该提交与其父提交之间的差异。

1. 要查看另一个分支中文件的更改历史记录，请使用分支选择器将视图切换到该分支，从文件列表中选择文件，然后选择**查看历史记录**。

**注意**  
您无法在 CodeCatalyst 控制台中查看 Git 子模块的更改历史记录。有关 Git 子模块的更多信息，请参阅 [Git 文档](https://git-scm.com/book/en/v2/Git-Tools-Submodules)。

# 编辑文件
<a name="source-files-edit"></a>

您可以在 Amazon CodeCatalyst 控制台中编辑单个文件。要同时编辑多个文件，您可以创建一个开发环境或者克隆存储库，然后使用 Git 客户端或集成式开发环境（IDE）进行更改。有关更多信息，请参阅 [使用开发环境编写和修改代码 CodeCatalyst使用开发环境编写和修改代码](devenvironment.md)或 [克隆源存储库](source-repositories-clone.md)。

**在 CodeCatalyst 控制台中编辑文件**

1. 导航到要在其中编辑文件的项目。有关如何导航到存储库的更多信息，请参阅[查看源存储库](source-repositories-view.md)。

1. 选择要编辑其中文件的存储库。选择**查看分支**，然后选择要在其中工作的分支。从该分支的文件和文件夹列表中选择文件。

   文件内容将显示出来。

1. 选择**编辑**。

1. 在编辑器中，编辑文件内容，然后选择**提交**。（可选）在**提交更改**中，在**提交消息**中添加有关更改的更多信息。对更改感到满意后，选择**提交**。

# 重命名或删除文件
<a name="source-files-delete"></a>

您可以在开发环境、本地计算机或集成式开发环境（IDE）中重命名或删除文件。重命名或删除文件后，提交并将这些更改推送到源存储库。您无法在 Amazon CodeCatalyst 控制台中重命名或删除文件。