本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 編輯 AWS CodeCommit 儲存庫中檔案的內容
<a name="how-to-edit-file"></a>

您可以使用 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)

## 編輯檔案 （主控台）
<a name="how-to-edit-file-console"></a>

您可以使用 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)
<a name="how-to-edit-file-cli"></a>

您可以使用 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)
<a name="how-to-edit-file-git"></a>

您可以編輯本機儲存庫中的檔案，並將變更推送至 CodeCommit 儲存庫。如需詳細資訊，請參閱[Git 和 入門 AWS CodeCommit](getting-started.md)。