本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
疑难解答 Amazon Toolkit for Visual Studio
以下各节包含有关 Amazon Toolkit for Visual Studio 和使用该工具包中的 Amazon 服务的一般疑难解答信息。
注意
安装和 set-up-specific疑难解答信息可在本用户指南中的安装问题疑难解答主题中找到。
问题排查最佳实践
以下是推荐使用的 Amazon Toolkit for Visual Studio 问题排查最佳实践。
-
修复 Visual Studio 并重新启动系统
-
在发送报告之前，尝试重现问题或错误。
-
详细记录重现过程中的每个步骤、设置和错误消息。
-
收集 Amazon 工具包日志。有关如何查找 Amazon Toolkit 日志的详细说明，请参阅本指南主题中的 “如何找到您的 Amazon 日志” 过程。
-
查看未解决的请求、已知的解决方案，或者在 Amazon Toolkit for Visual Studio GitHub 存储库的 “Amazon Toolkit for Visual Studio 问题
” 部分报告未解决的问题。
修复 Visual Studio 并重新启动系统
-
关闭所有正在运行的 Visual Studio 实例。
-
从 Windows 开始菜单中启动 Visual Studio 安装程序。
-
对受影响的 Visual Studio 安装程序运行 “修复”。这允许 Visual Studio 重建其已安装扩展的索引。
-
在重新启动 Visual Studio 之前重新启动 Windows。
如何找到你的 Amazon Toolkit 日志
-
在 Visual Studio 主菜单中，展开扩展。
-
选择Amazon 工具包以展开 Tool Amazon kit 菜单，然后选择查看 Toolkit 日志。
-
当 Amazon Toolkit 日志文件夹在您的操作系统中打开时，按日期对文件进行排序，然后找到任何包含与当前问题相关的信息的日志文件。
查看和筛选 Amazon Q 安全扫描
要在 Visual Studio 中查看您的 Amazon Q 安全扫描，请展开 Visual Studio 主菜单中的 “视图” 标题并选择 “错误列表”，打开 Visual Studio 错误列表。
默认情况下，Visual Studio 错误列表会显示您的代码库的所有警告和错误。要从 Visual Studio 错误列表中筛选出您的 Amazon Q 安全扫描结果，请完成以下步骤创建筛选器。
注意
只有在运行安全扫描并检测到问题后，Amazon Q 安全扫描结果才可见。
Amazon Q 安全扫描结果在 Visual Studio 中显示为警告。要查看错误列表中的 Amazon Q 安全扫描结果，必须选择 “错误列表” 标题中的 “警告” 选项。
-
从 Visual Studio 主菜单中，展开 “视图” 标题并选择 “错误列表”，打开 “错误列表” 窗格。
-
从错误列表窗格中，右键单击标题行，以打开上下文菜单。
-
在上下文菜单中，展开 “显示列”，然后在展开的菜单中选择 “工具”。
-
工具列已添加到您的错误列表中。
-
从 “工具” 列标题中，选择 “筛选” 图标并选择 Amazon Q 以筛选 Amazon Q 安全扫描结果。
Amazon 工具包安装不正确
问题：
在启动 Visual Studio 后的一分钟内，输出窗格和信息栏中将分别显示以下消息： Amazon Toolkit for Visual Studio
Some Toolkit components could not be initialized. Some functionality may not work
during this IDE session.
The Amazon Toolkit is not properly installed.
解决方案：
更新或安装扩展程序可能会导致 Visual Studio 的某些内部缓存文件失效 out-of-sync。以下过程介绍下次启动 Visual Studio 时如何重新生成这些文件。
注意
此解决方案可能会影响您的 Visual Studio 自定义设置。完成此过程后， Amazon Toolkit 扩展应列为已安装且不再报告错误消息。如果您在完成以下步骤后仍然遇到此问题，请参阅 Amazon Toolkit for Visual Studio GitHub 存储库中的问题 #452
-
安装最新版本的 Visual Studio 2022。
注意
所需的最低版本为 17.11.5。
-
关闭所有正在运行的 Visual Studio 实例。
-
在 Windows 中，以管理员身份打开开发者命令提示符。
-
在开发者命令提示符下，运行以下命令：
devenv /updateconfiguration /resetExtensions，然后等待命令完成。 -
命令完成后，重新启动 Visual Studio。
-
在 Visual Studio 中，该 Amazon 扩展现在列为已安装，不再报告此问题顶部列出的错误消息。
防火墙和代理设置
防火墙和代理设置疑难解答
安全扫描软件可能会从下载中删除文件或完全阻止下载，从而干扰您从 Amazon Toolkit 语言服务器下载文件的能力。
要检查您的防火墙和代理设置，请使用与 Visual https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/Studio 实例安装在同一系统上的互联网浏览器导航到 0/manifest.jsonaws-toolkit-language-servers.amazonaws.com。
自定义证书
Amazon Toolkit for Visual Studio 使用在 Node.js 运行时上运行的语言服务器。有关如何检查您的网络是否使用自定义证书的详细信息，请参阅版本 1 Amazon Command Line Interface用户指南 Amazon CLI主题中的配置和凭证文件设置。
要配置代理设置和定义证书，必须配置HTTPS_PROXY环境变量并为NODE_OPTIONS和NODE_EXTRA_CA_CERTS密钥创建 Windows 环境变量。
要配置 HTTPS_PROXY env 变量，请完成以下步骤。
-
从 Visual Studio 主菜单中选择 “工具”，然后选择 “选项”。
-
从 “选项” 菜单中展开 “Amazon 工具包”，然后选择 “代理”。
-
在 “代理” 菜单中，定义您的主机和端口。
注意
有关HTTPS_PROXY从中配置的信息 Amazon CLI，请参阅《Amazon Command Line Interface用户指南》中该 Amazon CLI主题的 “使用 HTTP 代理”。
为以下密钥创建 Windows 环境变量。
-
NODE_OPTIONS = --use-openssl-ca -
NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs
注意
有关提取企业根证书的更多信息，请参阅 le ar n.microsoft.co m 上的 “使用私钥导出证书
允许发布商品和其他步骤
除了干扰 Amazon Toolkit 语言服务器外，防火墙设置还可以阻止 Amazon Q 上传到 Amazon S3 并调用服务 API。为了最大限度地减少这些错误的可能性，我们建议允许以下终端节点通过端口 443 (HTTPS) 进行出站互联网访问：
-
https://codewhisperer.us-east-1.amazonaws.com/ -
https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/ -
https://aws-toolkit-language-servers.amazonaws.com/ -
https://q.us-east-1.amazonaws.com -
https://client-telemetry.us-east-1.amazonaws.com -
https://cognito-identity.us-east-1.amazonaws.com -
https://oidc.us-east-1.amazonaws.com
如果您仍然遇到防火墙和代理问题，请收集您的 Amazon Toolkit 日志，并通过 Amazon Toolkit for Visual Studio GitHub 存储库的 “Amazon Toolkit for Visual Studio 问题