

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

# 使用程式碼參考
<a name="code-reference"></a>

Amazon Q 的某些部分是從開放原始碼專案學習。有時候它提供的建議可能與公開提供的程式碼類似。程式碼參考包含 Amazon Q 用於產生建議的來源相關的資訊。

**Topics**
+ [檢視和更新程式碼參考](#show-code-reference)
+ [關閉和開啟程式碼參考](#toggle-code-reference)
+ [選擇退出包含參考的程式碼](#opt-out-code-reference)

## 檢視和更新程式碼參考
<a name="show-code-reference"></a>

您可以使用參考日誌來檢視與公開提供的程式碼類似的程式碼建議參考。您也可以更新和編輯 Amazon Q 提供的程式碼建議。

選擇您的 IDE，即可查看檢視和更新程式碼參考的步驟。

------
#### [ Visual Studio 程式碼 ]

若要在 VS Code 中顯示 Amazon Q 參考日誌，請依照下列程序執行。

1. 確定您使用的是最新版的 VS Code 和 Amazon Q 延伸模組。

1. 在 VS Code 中，從 IDE 視窗底部的元件匣中選擇 **Amazon Q**。

   Amazon Q 任務列會在 IDE 視窗頂端開啟。

1. 選擇**開啟程式碼參考日誌**。

   程式碼參考日誌索引標籤隨即開啟。當中會列出程式碼建議的所有參考。

下圖顯示開啟的 Amazon Q 任務列和程式碼參考日誌索引標籤。

![\[Visual Studio Code 中的 Amazon Q 程式碼參考日誌。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/VSC-coderef.png)


------
#### [ JetBrains ]

若要在 JetBrains IDE 中顯示 Amazon Q 參考日誌，請依照下列程序執行。

1. 確定您使用的是最新版的 JetBrains IDE 和 Amazon Q 外掛程式。

1. 在 JetBrains 中，從 IDE 視窗底部的狀態列中選擇 **Amazon Q**。

   Amazon Q 任務列會在狀態列上方開啟。

1. 選擇**開啟程式碼參考日誌**。

   程式碼參考日誌索引標籤隨即開啟。當中會列出程式碼建議的所有參考。

下圖顯示開啟的 Amazon Q 任務列和程式碼參考日誌索引標籤。

![\[JetBrains 中的 Amazon Q 程式碼參考日誌。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/JB-coderef.png)


------
#### [ Eclipse ]

若要在 Eclipse IDE 中顯示 Amazon Q 參考日誌，請依照下列程序執行。

1. 確定您使用的是最新版的 Eclipse IDE 和 Amazon Q 外掛程式。

1. 在 Eclipse IDE 中，於 IDE 右上角選擇 **Amazon Q** 圖示。

1. 在 Amazon Q 聊天索引標籤開啟的情況下，選擇索引標籤右上角的省略符號圖示。Amazon Q 任務列隨即開啟。

   下圖顯示 Eclipse IDE 中的 Amazon Q 任務列。  
![\[Eclipse IDE 中的 Amazon Q 任務列。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png)

1. 選擇**開啟程式碼參考日誌**。

   程式碼參考日誌索引標籤隨即開啟。當中會列出程式碼建議的所有參考。

------
#### [ Toolkit for Visual Studio ]

當 Amazon Q 建議的程式碼包含 Toolkit for Visual Studio 中的參考時，參考類型會出現在建議說明中。

![\[Code snippet showing a function to create a DynamoDB table with 'Products' as the table name.\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/visual-studio-view-code-suggestions.png)


所有已接受且包含參考的建議都會在參考日誌中擷取。

若要存取參考日誌，請選擇 AWS 圖示，然後選取**開啟程式碼參考日誌**。

已接受且包含參考的建議清單將會出現。此清單包含：
+ 接受建議的位置。按兩下此項將會帶您前往程式碼中的該位置。
+ 相關聯的授權
+ 參考的原始程式碼
+ 屬於參考的程式碼片段

![\[CodeWhisperer Reference Log output showing accepted recommendation with MIT license.\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/vstudio-reference-log2.png)


------
#### [ AWS Cloud 9 ]

當您搭配 AWS Cloud 9 使用 Amazon Q 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 在 AWS Cloud 9 主控台的左上角，選擇 AWS Cloud 9 標誌。

1. 從下拉式功能表中，選擇**偏好設定**。

   **偏好設定**索引標籤會在主控台右側開啟。

1. 在**偏好設定**索引標籤的**專案設定**下，於**延伸模組**下選取 **AWS Toolkit**。

1. 選取或取消選取 **Amazon Q：包含有程式碼參考的建議**。

------
#### [ Lambda ]

Lambda 中的 Amazon Q 不支援程式碼參考。當您使用 Amazon Q 搭配 Lambda 時，系統會省略任何包含參考的程式碼建議。

------
#### [ SageMaker AI Studio ]

若要在 SageMaker AI Studio 中顯示 Amazon Q 參考日誌，請依照下列程序執行。

1. 在 SageMaker AI Studio 視窗底部，開啟 Amazon Q 面板。

1. 選擇**開啟程式碼參考日誌**。

------
#### [ JupyterLab ]

若要在 JupyterLab 中顯示 Amazon Q 參考日誌，請依照下列程序執行。

1. 在 JupyterLab 視窗底部，開啟 Amazon Q 面板。

1. 選擇**開啟程式碼參考日誌**。

------
#### [ AWS Glue Studio Notebook ]

若要在 AWS Glue Studio 筆記本中顯示 Amazon Q 參考日誌，請使用下列程序。

1. 在 AWS Glue Studio Notebook 視窗底部，開啟 Amazon Q 面板。

1. 選擇**開啟程式碼參考日誌**。

------

## 關閉和開啟程式碼參考
<a name="toggle-code-reference"></a>

在大多數 IDE 中，程式碼參考預設為開啟。選擇您的 IDE，即可查看關閉或開啟程式碼參考的步驟。

------
#### [ Visual Studio 程式碼 ]

當您使用 Amazon Q 搭配 VS Code 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 確定您使用的是最新版的 VS Code 和 Amazon Q 延伸模組。

1. 在 VS Code 中，從 IDE 視窗底部的元件匣中選擇 **Amazon Q**。

   Amazon Q 任務列會在 IDE 視窗頂端開啟。

1. 選擇**開啟設定**。設定索引標籤隨即開啟，其中會顯示與 Amazon Q 相關的選項。

1. 選取或取消選取**顯示包含參考的程式碼**旁的方塊。

------
#### [ JetBrains ]

當您使用 Amazon Q 搭配 JetBrains IDE 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 確定您使用的是最新版的 JetBrains IDE 和 Amazon Q 外掛程式。

1. 在 JetBrains 中，從 IDE 視窗底部的狀態列中選擇 **Amazon Q**。

   Amazon Q 任務列會在狀態列上方開啟。

1. 選擇**開啟設定**。設定視窗隨即開啟，其中會顯示與 Amazon Q 相關的選項。

1. 選取或取消選取**顯示包含參考的程式碼**旁的方塊。

------
#### [ Eclipse ]

當您使用 Amazon Q 搭配 Eclipse 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 確定您使用的是最新版的 Eclipse IDE 和 Amazon Q 外掛程式。

1. 在 Eclipse IDE 中開啟**設定**。

1. 從左側導覽列選擇 **Amazon Q**。

1. 選取或取消選取**顯示包含參考的程式碼**旁的方塊。

1. 選擇 **Apply (套用)** 來儲存您的變更。

------
#### [ Toolkit for Visual Studio ]

當您在 Toolkit for Visual Studio 中使用 Amazon Q 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 確定您使用的是最新版的 Toolkit for Visual Studio。

1. 在 Visual Studio 中開啟**選項**。

1. 從左側導覽列選擇 **AWS Toolkit**，然後選擇 **Amazon Q**。

1. 從**包含具有參考的建議**旁的下拉式清單中選取 True 或 False。

1. 選擇 **OK (確定)** 以儲存變更。

------
#### [ AWS Cloud 9 ]

當您搭配 AWS Cloud 9 使用 Amazon Q 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 在 AWS Cloud 9 主控台的左上角，選擇 AWS Cloud 9 標誌。

1. 從下拉式功能表中，選擇**偏好設定**。

   **偏好設定**索引標籤會在主控台右側開啟。

1. 在**偏好設定**索引標籤的**專案設定**下，於**延伸模組**下選取 **AWS Toolkit**。

1. 選取或取消選取 **Amazon Q：包含有程式碼參考的建議**。

------
#### [ Lambda ]

Lambda 中的 Amazon Q 不支援程式碼參考。當您使用 Amazon Q 搭配 Lambda 時，系統會省略任何包含參考的程式碼建議。

------
#### [ SageMaker AI Studio ]

當您使用 Amazon Q 搭配 SageMaker AI Studio 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 從 SageMaker AI Studio 視窗頂端，選擇**設定**。

1. 從**設定**下拉式清單中，選擇**進階設定編輯器**。

1. 在 Amazon Q 下拉式清單中，選取或取消選取**啟用包含程式碼參考的建議**旁的方塊。

------
#### [ JupyterLab ]

當您使用 Amazon Q 搭配 JupyterLab 時，程式碼參考預設為開啟。

若要關閉程式碼參考，或稍後再將其重新開啟，請依照下列程序執行。

1. 從 JupyterLab 視窗頂端，選擇**設定**。

1. 從**設定**下拉式清單中，選擇**進階設定編輯器**。

1. 在 Amazon Q 下拉式清單中，選取或取消選取**啟用包含程式碼參考的建議**旁的方塊。

------
#### [ AWS Glue Studio Notebook ]

1. 從 AWS Glue Studio Notebook 視窗底部選擇 **Amazon Q**。

1. 從快顯功能表中，切換**包含參考的程式碼**旁的開關。

**注意**  
暫停程式碼參考僅在目前 AWS Glue Studio 筆記本的持續時間內有效。

------

## 選擇退出包含參考的程式碼
<a name="opt-out-code-reference"></a>

在某些 IDE 中，您可以在管理員層級選擇不接收包含參考的建議。

選擇您的 IDE，即可查看以管理員身分選擇退出的步驟。

------
#### [ Visual Studio 程式碼 ]

如果您是企業管理員，您可以針對整個組織選擇退出包含程式碼參考的建議。如果您這樣做，組織中的個別開發人員將無法透過 IDE 重新選擇加入。這些開發人員將能夠選取和取消選取上一節所述的方塊，但如果您已在企業層級選擇退出，則開發人員的操作不會有任何作用。

若要在企業層級選擇退出包含參考的建議，請依照下列程序執行。

1. 在 Amazon Q Developer 主控台中，選擇**設定**。

1. 在 **Amazon Q Developer 帳戶詳細資訊**窗格中，選擇**編輯**。

1. 在「編輯詳細資訊」頁面的**進階設定**窗格中，取消選取**包含具有程式碼參考的建議**。

1. 選擇**儲存變更**。

------
#### [ JetBrains ]

如果您是企業管理員，您可以針對整個組織選擇退出包含程式碼參考的建議。如果您這樣做，組織中的個別開發人員將無法透過 IDE 重新選擇加入。這些開發人員將能夠選取和取消選取上一節所述的方塊，但如果您已在企業層級選擇退出，則開發人員的操作不會有任何作用。

若要在企業層級選擇退出包含參考的建議，請依照下列程序執行。

1. 在 Amazon Q Developer 主控台中，選擇**設定**。

1. 在 **Amazon Q Developer 帳戶詳細資訊**窗格中，選擇**編輯**。

1. 在「編輯詳細資訊」頁面的**進階設定**窗格中，取消選取**包含具有程式碼參考的建議**。

1. 選擇**儲存變更**。

------
#### [ Eclipse ]

如果您是企業管理員，您可以針對整個組織選擇退出包含程式碼參考的建議。如果您這樣做，組織中的個別開發人員將無法透過 IDE 重新選擇加入。這些開發人員將能夠選取和取消選取上一節所述的方塊，但如果您已在企業層級選擇退出，則開發人員的操作不會有任何作用。

若要在企業層級選擇退出包含參考的建議，請依照下列程序執行。

1. 在 Amazon Q Developer 主控台中，選擇**設定**。

1. 在 **Amazon Q Developer 帳戶詳細資訊**窗格中，選擇**編輯**。

1. 在「編輯詳細資訊」頁面的**進階設定**窗格中，取消選取**包含具有程式碼參考的建議**。

1. 選擇**儲存變更**。

------
#### [ Toolkit for Visual Studio ]

若要在企業層級選擇退出包含參考的建議，請依照下列程序執行。

1. 您可以透過兩種方式之一進入程式碼參考設定：

   1. 在視窗邊緣選擇 Amazon Q 圖示，然後選擇**選項...**

   1. 前往**工具** -> **AWS Toolkit** -> **Amazon Q**

1. 根據您是否要包含具有參考的建議，將切換開關變更為 **True** 或 **False**。

------
#### [ AWS Cloud 9 ]

Cloud 9 AWS 中的 Amazon Q 不支援在企業層級使用 參考選擇退出程式碼建議。

若要在個別開發人員層級選擇退出，請參閱「切換程式碼參考」。

------
#### [ Lambda ]

Lambda 中的 Amazon Q 不支援程式碼參考。當您使用 Amazon Q 搭配 Lambda 時，系統會省略任何包含參考的程式碼建議。

------
#### [ SageMaker AI Studio ]

在 SageMaker AI Studio 中，Amazon Q 不支援在企業層級選擇退出包含參考的程式碼建議。

------
#### [ JupyterLab ]

在 JupyterLab 中，Amazon Q 不支援在企業層級選擇退出包含參考的程式碼建議。

------
#### [ AWS Glue Studio Notebook ]

Amazon Q 不支援在 AWS Glue Studio 筆記本中使用參考來選擇退出程式碼建議。

------