

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

# 使用代码引用
<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 Code ]

要在 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_cn/amazonq/latest/qdeveloper-ug/images/VSC-coderef.png)


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

要在 JetBrains IDEs 中显示 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_cn/amazonq/latest/qdeveloper-ug/images/JB-coderef.png)


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

要在 Eclipse IDEs 中显示 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_cn/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_cn/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_cn/amazonq/latest/qdeveloper-ug/images/vstudio-reference-log2.png)


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

当您将 Amazon Q 与 AWS Cloud 9 配合使用时，代码引用默认处于启用状态。

要将其关闭或稍后重新启用，请遵循以下流程。

1. 在 AWS Cloud 9 控制台的左上角，选择 AWS Cloud 9 徽标。

1. 从下拉菜单中选择**首选项**。

   在控制台的右侧，**首选项**选项卡将打开。

1. 在**首选项**选项卡中**项目设置**下的**扩展**下，选择 **AWS Toolkit**。

1. 选择或取消选择 **Amazon Q：包含带有代码引用的建议**。

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

Lambda 中的 Amazon Q 不支持代码引用。当您将 Amazon Q 与 Lambda 配合使用时，任何带有引用的代码建议都将被忽略。

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

要在 A SageMaker I Studio 中显示 Amazon Q 参考日志，请按以下步骤操作。

1. 在 SageMaker AI Studio 窗口的底部，打开 Amazon Q 面板。

1. 选择**打开代码引用日志**。

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

要显示 Amazon Q 参考登录信息 JupyterLab，请按以下步骤操作。

1. 在 JupyterLab 窗口底部，打开 Amazon Q 面板。

1. 选择**打开代码引用日志**。

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

要在 AWS Glue Studio Notebook 中显示 Amazon Q 参考日志，请按以下步骤操作。

1. 在 AWS Glue Studio Notebook 窗口的底部，打开 Amazon Q 面板。

1. 选择**打开代码引用日志**。

------

## 关闭和启用代码引用
<a name="toggle-code-reference"></a>

在大多数情况下 IDEs，默认情况下，代码引用处于启用状态。选择您的 IDE 以查看有关如何关闭和启用代码引用的步骤。

------
#### [ Visual Studio Code ]

当您将 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. 选择**确定**以保存您的更改。

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

当您将 Amazon Q 与 AWS Cloud 9 配合使用时，代码引用默认处于启用状态。

要将其关闭或稍后重新启用，请遵循以下流程。

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 与 A SageMaker I Studio 配合使用时，代码引用默认处于开启状态。

要将其关闭或稍后重新启用，请遵循以下流程。

1. 从 A SageMaker I 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>

在某些 IDEs情况下，您可以选择不接收带有管理员级别推荐人的建议。

选择您的 IDE 以了解以管理员身份选择停用的步骤。

------
#### [ Visual Studio Code ]

如果您是企业管理员，则可以针对整个组织选择停用带有代码引用的建议。如果您这样做，则组织中的个人开发者将无法通过 IDE 重新选择启用。这些开发者将能够选中和取消选中上一节中讨论的复选框，但是如果您在企业级别选择停用，则开发者的选择不会产生任何影响。

要在企业级选择停用带有引用的建议，请遵循以下流程。

1. 在 Amazon Q 开发者版控制台中，选择**设置**。

1. 在 **Amazon Q 开发者版账户详情**窗格中，选择**编辑**。

1. 在“编辑详细信息”页面的**高级设置**窗格中，取消选择**包含带有代码引用的建议**。

1. 选择**保存更改**。

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

如果您是企业管理员，则可以针对整个组织选择停用带有代码引用的建议。如果您这样做，则组织中的个人开发者将无法通过 IDE 重新选择启用。这些开发者将能够选中和取消选中上一节中讨论的复选框，但是如果您在企业级别选择停用，则开发者的选择不会产生任何影响。

要在企业级选择停用带有引用的建议，请遵循以下流程。

1. 在 Amazon Q 开发者版控制台中，选择**设置**。

1. 在 **Amazon Q 开发者版账户详情**窗格中，选择**编辑**。

1. 在“编辑详细信息”页面的**高级设置**窗格中，取消选择**包含带有代码引用的建议**。

1. 选择**保存更改**。

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

如果您是企业管理员，则可以针对整个组织选择停用带有代码引用的建议。如果您这样做，则组织中的个人开发者将无法通过 IDE 重新选择启用。这些开发者将能够选中和取消选中上一节中讨论的复选框，但是如果您在企业级别选择停用，则开发者的选择不会产生任何影响。

要在企业级选择停用带有引用的建议，请遵循以下流程。

1. 在 Amazon Q 开发者版控制台中，选择**设置**。

1. 在 **Amazon Q 开发者版账户详情**窗格中，选择**编辑**。

1. 在“编辑详细信息”页面的**高级设置**窗格中，取消选择**包含带有代码引用的建议**。

1. 选择**保存更改**。

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

要在企业级选择停用带有引用的建议，请遵循以下流程。

1. 您可以通过以下两种方式之一进入代码引用设置：

   1. 选择窗口边缘的 Amazon Q 图标，然后选择**选项…**

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

1. 将切换开关更改为**是**或**否**，具体取决于您是否要包含带引用的建议。

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

 AWS Cloud 9 中的 Amazon Q 不支持选择退出带有企业级参考的代码建议。

要在个人开发者级别选择停用，请参阅“Toggling code references”。

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

Lambda 中的 Amazon Q 不支持代码引用。当您将 Amazon Q 与 Lambda 配合使用时，任何带有引用的代码建议都将被忽略。

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

Amazon Q 不支持在 A SageMaker I Studio 中选择退出带有企业级参考的代码建议。

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

Amazon Q 不支持选择退出带有企业级参考的代码建议。 JupyterLab

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

Amazon Q 不支持在 AWS Glue Studio Notebook 中选择不使用带有参考的代码建议。

------