本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 疑难解答 AWS Toolkit for Visual Studio
以下各节包含有关 AWS Toolkit for Visual Studio 和使用该工具包中的 AWS 服务的一般疑难解答信息。
**注意**
安装和 set-up-specific疑难解答信息可在本用户指南中的[安装问题疑难解答](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html)主题中找到。
**Topics**
+ [问题排查最佳实践](#general-troubleshoot-best-practice)
+ [查看和筛选 Amazon Q 安全扫描](#general-troubleshoot-Q-securityscan)
+ [AWS 工具包安装不正确](#general-troubleshoot-component-initilization)
+ [防火墙和代理设置](#general-troubleshoot-firewall)
## 问题排查最佳实践
以下是推荐使用的 AWS Toolkit for Visual Studio 问题排查最佳实践。
+ 修复 Visual Studio 并重新启动系统
+ 在发送报告之前，尝试重现问题或错误。
+ 详细记录重现过程中的每个步骤、设置和错误消息。
+ 收集 AWS 工具包日志。有关如何查找 AWS Toolkit 日志的详细说明，请参阅本指南主题中的 “[如何找到您的 AWS 日志](#general-troubleshoot-procedure-logs)” 过程。
+ 查看未解决的请求、已知的解决方案，或者在 AWS Toolkit for Visual Studio GitHub 存储库的 “[AWS Toolkit for Visual Studio 问题](https://github.com/aws/aws-toolkit-visual-studio/issues)” 部分报告未解决的问题。
**修复 Visual Studio 并重新启动系统**
1. 关闭所有正在运行的 Visual Studio 实例。
1. 从 Windows“开始”菜单中启动 **Visual Studio 安装程序**。
1. 对受影响的 Visual Studio 安装运行“修复”。这允许 Visual Studio 重新构建其已安装扩展的索引。
1. 在重新启动 Visual Studio 之前重新启动 Windows。
**如何找到你的 AWS Toolkit 日志**
1. 在 Visual Studio 主菜单中，展开**扩展**。
1. 选择**AWS 工具包**以展开 Tool AWS kit 菜单，然后选择**查看 Toolkit 日志**。
1. 当 AWS 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 安全扫描结果，必须选择**错误列表**标题中的**警告**选项。
1. 从 Visual Studio 主菜单中展开**查看**标题，选择**错误列表**以打开**错误列表**窗格。
1. 从**错误列表**窗格中，右键单击标题行，以打开上下文菜单。
1. 在上下文菜单中，展开**显示列**，然后在展开的菜单中选择**工具**。
1. **工具**列已添加到您的**错误列表**中。
1. 从**工具**列标题中，选择**筛选**图标，选择 Amazon Q 以筛选 Amazon Q 安全扫描结果。
## AWS 工具包安装不正确
**问题：**
在启动 Visual Studio 后的一分钟内，输出窗格和信息栏中将分别显示以下消息： AWS Toolkit for Visual Studio
`Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.`
`The AWS Toolkit is not properly installed.`
**解决方案：**
更新或安装扩展程序可能会导致 Visual Studio 的某些内部缓存文件失效 out-of-sync。以下过程介绍如何让 Visual Studio 在下次启动时重新生成这些文件。
**注意**
此解决方案可能会影响您的 Visual Studio 自定义设置。完成此过程后， AWS Toolkit 扩展应列为已安装且不再报告错误消息。如果您在完成以下步骤后仍然遇到此问题，请参阅 AWS Toolkit for Visual Studio GitHub 存储库中的[问题 \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452) 以获取更多信息。
1. 安装 Visual Studio 2022 的最新版本。
**注意**
所需的最低版本为 17.11.5。
1. 关闭所有正在运行的 Visual Studio 实例。
1. 在 Windows 系统中，以管理员身份打开**开发者命令提示符**。
1. 在**开发者命令提示符**下，运行以下命令：`devenv /updateconfiguration /resetExtensions`，然后等待命令完成。
1. 命令完成后，重新启动 Visual Studio。
1. 在 Visual Studio 中，该 AWS 扩展现在列为已安装，不再报告此问题顶部列出的错误消息。
## 防火墙和代理设置
### 排查防火墙和代理设置故障
安全扫描软件可能会删除您从 AWS Toolkit 语言服务器下载的文件或完全阻止下载，从而干扰您的下载能力。
要检查您的防火墙和代理设置，请使用与 Visual [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/Studio 实例安装在同一系统上的互联网浏览器导航到 0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json)。如果您遇到错误或页面无法加载，则表明可能有防火墙或代理过滤器在阻止您访问 `aws-toolkit-language-servers.amazonaws.com`。
### 自定义证书
AWS Toolkit for Visual Studio 使用在 Node.js 运行时上运行的语言服务器。有关如何检查您的网络是否使用自定义证书的详细信息，请参阅《AWS Command Line Interface用户指南（版本 1）》**中的[AWS CLI中的配置和凭证文件设置](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle)。
要配置代理设置和定义证书，必须配置 `HTTPS_PROXY` 环境变量并为 `NODE_OPTIONS` 和 `NODE_EXTRA_CA_CERTS` 键创建 Windows 环境变量。
要配置 `HTTPS_PROXY` 环境变量，请完成以下步骤：
1. 从 Visual Studio 主菜单中选择**工具**，然后选择**选项**。
1. 从**选项**菜单中展开 **AWS Toolkit**，然后选择**代理**。
1. 在**代理**菜单中，定义您的**主机**和**端口**。
**注意**
有关`HTTPS_PROXY`从中配置的信息 AWS CLI，请参阅《*AWS Command Line Interface*用户指南》中[该 AWS CLI主题的 “使用 HTTP 代理](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html)”。
为以下键创建 Windows 环境变量。
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs`
**注意**
有关提取企业根证书的更多信息，请参阅 *learn.microsoft.com* 上的[使用私有密钥导出证书](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key)一文。有关 Windows 环境变量键的详细信息，请参阅 *nodejs.org* 上的 [Node.js v23.3.0 文档](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file)。
### 允许列表和额外步骤
除了干扰 AWS 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`
有关端点的详细列表，请参阅本用户指南中的[更新防火墙和网关以允许访问](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html)主题。有关为 Amazon Q 配置公司代理的详细信息，请参阅《Amazon Q 开发者版用户指南》中的**[在 Amazon Q 中配置公司代理](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy)主题。如果您仍然遇到防火墙和代理问题，请收集您的 AWS Toolkit 日志，并通过 AWS Toolkit for Visual Studio GitHub 存储库的 “[AWS Toolkit for Visual Studio 问题](https://github.com/aws/aws-toolkit-visual-studio/issues)” 部分与 AWS Toolkit for Visual Studio 团队联系。有关收集 AWS Toolkit 日志的详细信息，请查看本用户指南主题的 “**故障排除最佳实践**” 部分中的信息。