

Amazon 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：//[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 主控台中重新命名或刪除檔案。