疑难解答 Amazon Toolkit for Visual Studio - Amazon 带有 Amazon Q 的工具包
问题排查最佳实践查看和筛选 Amazon Q 安全扫描Amazon 工具包安装不正确
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

疑难解答 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 并重新启动系统

  1. 关闭所有正在运行的 Visual Studio 实例。

  2. 从 Windows 开始菜单中启动 Visual Studio 安装程序。

  3. 对受影响的 Visual Studio 安装程序运行 “修复”。这允许 Visual Studio 重建其已安装扩展的索引。

  4. 在重新启动 Visual Studio 之前重新启动 Windows。

如何找到你的 Amazon Toolkit 日志

  1. 在 Visual Studio 主菜单中，展开扩展。

  2. 选择Amazon 工具包以展开 Tool Amazon kit 菜单，然后选择查看 Toolkit 日志。

  3. 当 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 安全扫描结果，必须选择 “错误列表” 标题中的 “警告” 选项。

  1. 在 Visual Studio 主菜单中，展开 “视图” 标题并选择 “错误列表”，打开 “错误列表” 窗格。

  2. 在 “错误列表” 窗格中，右键单击标题行以打开快捷菜单。

  3. 在上下文菜单中，展开 “显示列”，然后在展开的菜单中选择 “工具”。

  4. 工具列已添加到您的错误列表中。

  5. 从 “工具” 列标题中，选择 “筛选” 图标并选择 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 以获取更多信息。

  1. 安装最新版本的 Visual Studio 2022。

    注意

    所需的最低版本为 17.11.5。

  2. 关闭所有正在运行的 Visual Studio 实例。

  3. 在 Windows 中，以管理员身份打开开发者命令提示符。

  4. 在开发者命令提示符下，运行以下命令：devenv /updateconfiguration /resetExtensions，然后等待命令完成。

  5. 命令完成后，重新启动 Visual Studio。

  6. 在 Visual Studio 中，该 Amazon 扩展现在列为已安装，不再报告此问题顶部列出的错误消息。