本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS CodeCommit 儲存庫中的檔案
在 CodeCommit 中，檔案是版本控制、獨立的資訊片段，可供您和儲存檔案的儲存庫和分支的其他使用者使用。就像在電腦上一樣，您可以用目錄結構來組織儲存庫檔案。與您的電腦不同，CodeCommit 會自動追蹤檔案的每個變更。您可以比較檔案的各個版本，並將檔案的不同版本存放在不同的儲存庫分支中。
若要在儲存庫中新增或編輯檔案，您可以使用 Git 用戶端。您也可以使用 CodeCommit 主控台 AWS CLI、 或 CodeCommit API。
![\[在 CodeCommit 主控台中建立檔案的檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-create-file.png)
如需在 CodeCommit 中使用儲存庫其他方面的詳細資訊，請參閱 [使用儲存庫](repositories.md)、[使用提取請求](pull-requests.md)、[使用分支](branches.md)、 [使用遞交](commits.md)和 [使用使用者偏好設定](user-preferences.md)。
**Topics**
+ [瀏覽 AWS CodeCommit 儲存庫中的檔案](how-to-browse.md)
+ [建立檔案或將檔案新增至 AWS CodeCommit 儲存庫](how-to-create-file.md)
+ [編輯 AWS CodeCommit 儲存庫中檔案的內容](how-to-edit-file.md)
# 瀏覽 AWS CodeCommit 儲存庫中的檔案
連線至 CodeCommit 儲存庫後，您可以將其複製到本機儲存庫，或使用 CodeCommit 主控台瀏覽其內容。本主題說明如何使用 CodeCommit 主控台來瀏覽 CodeCommit 儲存庫的內容。
**注意**
對於作用中的 CodeCommit 使用者，從 CodeCommit 主控台瀏覽程式碼無需付費。如需何時可能收費的詳細資訊，請參閱[定價](https://aws.amazon.com/codecommit/pricing/)。
![\[CodeCommit 主控台中檔案內容的檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-code-browse-file.png)
## 瀏覽 CodeCommit 儲存庫
您可以使用 CodeCommit 主控台來檢閱儲存庫中包含的檔案，或快速讀取檔案的內容。
**瀏覽儲存庫的內容**
1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。
1. 在 **Repositories (儲存庫)** 頁面上，從儲存庫清單選擇您想要瀏覽的儲存庫。
1. 在 **Code (程式碼)** 檢視中，瀏覽儲存庫預設分支的內容。
若要將檢視變更為不同的分支或標籤，請選擇檢視選取器按鈕。從下拉式清單選擇分支或標籤名稱，或是在篩選方塊中輸入分支或標籤的名稱，然後從清單中選擇它。
1. 執行以下任意一項：
+ 若要檢視目錄的內容，從清單中選擇目錄。您可以在導覽清單中選擇任何目錄以回到該目錄檢視。您也可以使用目錄清單上方的向上箭頭。
+ 若要檢視檔案的內容，從清單中選擇檔案。如果檔案大於遞交物件限制，就無法再顯示在主控台，必須改為在本機儲存庫中檢視。如需詳細資訊，請參閱[配額](limits.md)。若要結束檔案檢視，請從程式碼導覽列中，選擇您要檢視的目錄。
**注意**
並非所有二進位檔案都可在 主控台中檢視。如果您選擇二進位檔案且它可能可供檢視，則會出現警告訊息，要求您確認是否要顯示內容。若要檢視檔案，請選擇 **Show file contents (顯示檔案內容)**。若不要檢視檔案，請從程式碼導覽列中，選擇您要檢視的目錄。
如果您選擇 markdown 檔案 (.md)，請使用 **Rendered Markdown (轉譯的 Markdown)** 和 **Markdown Source (Markdown 來源)** 按鈕在轉譯和語法檢視之間切換。如需詳細資訊，請參閱 [主控台中的使用 Markdown](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)。
# 建立檔案或將檔案新增至 AWS CodeCommit 儲存庫
您可以使用 CodeCommit 主控台 AWS CLI或 Git 用戶端，將檔案新增至儲存庫。您可以從您的本機電腦上傳檔案至儲存庫，或者您可以使用主控台中的程式碼編輯器來建立檔案。編輯器是新增簡單檔案 (例如 readme.md 檔案) 至儲存庫中分支的一個快速且簡單的方式。
![\[在 CodeCommit 主控台中上傳檔案的檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-commit-first-file.png)
**Topics**
+ [建立或上傳檔案 （主控台）](#how-to-create-file-console)
+ [新增檔案 (AWS CLI)](#how-to-create-file-cli)
+ [新增檔案 (Git)](#how-to-create-file-git)
## 建立或上傳檔案 （主控台）
您可以使用 CodeCommit 主控台來建立檔案，並將其新增至 CodeCommit 儲存庫中的分支。在建立檔案時，您可以提供使用者名稱和電子郵件地址。您也可以新增遞交訊息，讓其他使用者了解是誰新增了該檔案，以及原因。您也可以直接從本機電腦將檔案上傳至儲存庫中的分支。
**將檔案新增到儲存庫**
1. 開啟 CodeCommit 主控台，網址為 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)。
1. 在 **Repositories (儲存庫)** 中，選擇您要新增檔案所在的儲存庫。
1. 在 **Code (程式碼)** 檢視中，選擇您要新增檔案所在的分支。依預設，當您開啟 **Code (程式碼)** 檢視時，會顯示預設分支的內容。
若要將檢視變更至不同的分支，請選擇檢視選取器按鈕。從下拉式清單選擇分支名稱，或是在篩選方塊中輸入分支的名稱，然後從清單中選擇它。
1. 選擇 **Add file (新增檔案)**，然後選擇以下其中一個選項：
+ 若要使用程式碼編輯器來建立檔案的內容，並將它新增至儲存庫，請選擇 **Create file (建立檔案)**。
+ 若要從您的本機電腦將檔案上傳至儲存庫，請選擇 **Upload file (上傳檔案)**。
1. 把將此檔案新增至儲存庫的人員和原因等相關資訊提供給其他使用者。
+ 在 **Author Name (作者名稱)** 中，輸入名稱。此名稱會同時做為遞交資訊中的作者名稱和遞交者名稱。CodeCommit 預設為使用您的 IAM 使用者名稱或主控台登入衍生做為作者名稱。
+ 在**電子郵件地址**中，輸入電子郵件地址，以便其他儲存庫使用者可以就此變更與您聯絡。
+ 在 **Commit message (遞交訊息)** 中，輸入簡短描述。此為選用步驟，但非常建議您加以執行。否則，會使用預設的遞交訊息。
1. 執行以下任意一項：
+ 如果您要上傳檔案，請從您的本機電腦選擇檔案。
+ 如果要建立檔案，請在程式碼編輯器中輸入您要新增的內容，並為檔案提供名稱。
1. 選擇 **Commit changes (遞交變更)**。
## 新增檔案 (AWS CLI)
您可以使用 AWS CLI 和 **put-file**命令在 CodeCommit 儲存庫中新增檔案。您也可以使用 **put-file** 命令來為檔案新增目錄或路徑結構。
**注意**
若要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 AWS CLI。如需詳細資訊，請參閱[命令列參考](cmd-ref.md)。
**將檔案新增到儲存庫**
1. 在本機電腦上，建立您要新增至 CodeCommit 儲存庫的檔案。
1. 在終端機或命令列，執行 **put-file** 命令，並指定：
+ 您要新增檔案所在的儲存庫。
+ 您要新增檔案所在的分支。
+ 對該分支所進行最新遞交的完整遞交 ID，也稱為頂端或標頭遞交。
+ 檔案的本機位置。用於此位置的語法因您的本機作業系統而有所不同。
+ 您要新增的檔案名稱，包括已更新檔案在儲存庫中的存放路徑 (如果有)。
+ 要與此檔案建立關聯的使用者名稱和電子郵件。
+ 說明為何新增此檔案的遞交訊息。
使用者名稱、電子郵件地址和遞交訊息是選用的，但可協助其他使用者知道誰進行了變更以及原因。如果您未提供使用者名稱，CodeCommit 會預設為使用您的 IAM 使用者名稱或主控台登入衍生做為作者名稱。
例如，若要將名為 *ExampleSolution.py* 的檔案新增至名為 *MyDemoRepo* 儲存庫中名為 *feature-randomizationfeature* 的分支，且其最近遞交的 ID 為 *4c925148EXAMPLE*，請執行下列動作：
```
aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I added a third randomization routine."
```
**注意**
新增二進位檔案時，請確定您使用 `fileb://` 來指定本機檔案的位置。
如果此命令成功執行，您會看到類似如下的輸出傳回：
```
{
"blobId": "2eb4af3bEXAMPLE",
"commitId": "317f8570EXAMPLE",
"treeId": "347a3408EXAMPLE"
}
```
## 新增檔案 (Git)
您可以在本機儲存庫中新增檔案，並將變更推送至 CodeCommit 儲存庫。如需詳細資訊，請參閱[Git 和 入門 AWS CodeCommit](getting-started.md)。
# 編輯 AWS CodeCommit 儲存庫中檔案的內容
您可以使用 CodeCommit 主控台 AWS CLI或 Git 用戶端來編輯 CodeCommit 儲存庫中檔案的內容。
![\[在 CodeCommit 主控台中編輯檔案的檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-edit-file.png)
**Topics**
+ [編輯檔案 （主控台）](#how-to-edit-file-console)
+ [編輯或刪除檔案 (AWS CLI)](#how-to-edit-file-cli)
+ [編輯檔案 (Git)](#how-to-edit-file-git)
## 編輯檔案 （主控台）
您可以使用 CodeCommit 主控台來編輯已新增至 CodeCommit 儲存庫中分支的檔案。在編輯檔案時，您可以提供您的使用者名稱和電子郵件地址。您也可以新增遞交訊息，讓其他使用者了解是誰做此變更，以及變更原因。
**編輯儲存庫中的檔案**
1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。
1. 在 **Repositories (儲存庫)** 中，選擇您要編輯的檔案所在的儲存庫。
1. 在 **Code (程式碼)** 檢視中，選擇您要編輯的檔案所在的分支。依預設，當您開啟 **Code (程式碼)** 檢視時，會顯示預設分支的內容。
若要將檢視變更至不同的分支，請選擇檢視選取器按鈕。從下拉式清單選擇分支名稱，或是在篩選方塊中輸入分支的名稱，然後從清單中選擇它。
1. 導覽分支的內容，選擇您要編輯的檔案。在檔案檢視中，選擇 **Edit (編輯)**。
**注意**
如果您選擇二進位檔案，則會出現警告訊息，請求您確認是否要顯示內容。您不應該使用 CodeCommit 主控台來編輯二進位檔案。
1. 編輯檔案，並將做此變更的使用者及變更原因等資訊提供給其他使用者。
+ 在 **Author Name (作者名稱)** 中，輸入名稱。此名稱同時用作遞交資訊中的作者名稱和遞交者名稱。CodeCommit 預設為使用您的 IAM 使用者名稱或主控台登入衍生做為作者名稱。
+ 在**電子郵件地址**中，輸入電子郵件地址，以便其他儲存庫使用者可以就此變更與您聯絡。
+ 在 **Commit message (遞交訊息)** 中，輸入變更的簡短描述。
1. 選擇 **Commit changes (遞交變更)**，儲存您對檔案所做的變更，並將變更遞交到儲存庫。
## 編輯或刪除檔案 (AWS CLI)
您可以使用 AWS CLI 和 **put-file**命令來變更 CodeCommit 儲存庫中的檔案。若要將已變更的檔案存放在不同於原始檔案的位置，您也可以使用 **put-file** 命令為已變更的檔案新增目錄或路徑結構。如果您想要刪除整個檔案，可以使用 **delete-file** 命令。
**注意**
若要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 AWS CLI。如需詳細資訊，請參閱[命令列參考](cmd-ref.md)。
**編輯儲存庫中的檔案**
1. 使用檔案的本機副本，進行您要新增至 CodeCommit 儲存庫的變更。
1. 在終端機或命令列，執行 **put-file** 命令，並指定：
+ 要新增已編輯檔案的儲存庫。
+ 要新增已編輯檔案的分支。
+ 對該分支所進行最新遞交的完整遞交 ID，也稱為頂端或標頭遞交。
+ 檔案的本機位置。
+ 您要新增的已更新檔案名稱，包括已更新檔案在儲存庫中的存放路徑 (如果有)。
+ 要與此檔案變更建立關聯的使用者名稱和電子郵件。
+ 用以說明您所做變更的遞交訊息。
使用者名稱、電子郵件地址和遞交訊息是選用的，但可協助其他使用者知道誰進行了變更以及原因。如果您不提供使用者名稱，CodeCommit 會預設為使用您的 IAM 使用者名稱或主控台登入的衍生。
例如，若要將 *ExampleSolution.py* 檔案新增至 *MyDemoRepo* 儲存庫中的 *feature-randomizationfeature* 分支，且其最近遞交的 ID 為 *4c925148EXAMPLE*，請執行下列動作：
```
aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I fixed the bug Mary found."
```
**注意**
如果您想要新增已變更的二進位檔案，請務必使用 `--file-content` 搭配標記法 `fileb://MyDirectory/MyFile.raw`。
如果此命令成功執行，您會看到類似如下的輸出傳回：
```
{
"blobId": "2eb4af3bEXAMPLE",
"commitId": "317f8570EXAMPLE",
"treeId": "347a3408EXAMPLE"
}
```
若要刪除檔案，請使用 **delete-file** 命令。例如，若要在名為 *MyDemoRepo* 的儲存庫中刪除名為 *main* 且遞交 ID 為 *c5709475EXAMPLE* 的分支中名為 *README.md* 的檔案：
```
aws codecommit delete-file --repository-name MyDemoRepo --branch-name main --file-path README.md --parent-commit-id c5709475EXAMPLE
```
如果此命令成功執行，您會看到類似如下的輸出傳回：
```
{
"blobId":"559b44fEXAMPLE",
"commitId":"353cf655EXAMPLE",
"filePath":"README.md",
"treeId":"6bc824cEXAMPLE"
}
```
## 編輯檔案 (Git)
您可以編輯本機儲存庫中的檔案，並將變更推送至 CodeCommit 儲存庫。如需詳細資訊，請參閱[Git 和 入門 AWS CodeCommit](getting-started.md)。