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

# 排查 AWS Toolkit for Visual Studio 安装问题
<a name="setup-troubleshoot"></a>

已知以下信息可以解决设置 AWS Toolkit for Visual Studio 时的常见安装问题。

如果您在安装 AWS Toolkit for Visual Studio 时遇到错误，或者不清楚安装是否已完成，请查看以下各部分中的信息。

## Visual Studio 管理员权限
<a name="setup-troubleshoot-admin"></a>

AWS Toolkit for Visual Studio 扩展需要管理员权限才能确保可访问所有 AWS 服务和功能。

如果您拥有本地管理员权限，则您的管理员权限可能无法直接扩展到 Visual Studio 实例。

要使用管理员权限在本地启动 Visual Studio，请执行以下操作：

1. 在 Windows 中，找到 Visual Studio 应用程序启动器（图标）。

1. 右键单击 Visual Studio 图标，以打开上下文菜单。

1. 从上下文菜单中选择**以管理员身份运行**。

要使用管理员权限远程启动 Visual Studio，请执行以下操作：

1. 在 Windows 中，找到您用于连接到远程 Visual Studio 实例的应用程序的应用程序启动器。

1. 右键单击应用程序，以打开上下文菜单。

1. 从上下文菜单中选择**以管理员身份运行**。

**注意**  
无论您是在本地启动程序还是远程连接到程序，Windows 都可能提示您确认管理凭证。

## 获取安装日志
<a name="setup-troubleshoot-install-log"></a>

如果您已经完成了上述*管理员权限*部分中的步骤，并且确认您正在使用管理员权限运行或连接到 Visual Studio，那么获取安装日志文件可帮助您诊断其他问题。

要通过 `.vsix` 文件手动安装 AWS Toolkit for Visual Studio 并生成安装日志文件，请完成以下步骤。

1. 在 [AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/) 登录页面上，点击**下载**链接，保存要安装的 AWS Toolkit for Visual Studio 版本的 `.vsix` 文件。

1. 从 Visual Studio 主菜单中，展开**工具**标题，展开**命令行**子菜单，然后选择 **Visual Studio 开发人员命令提示**。

1. 在 **Visual Studio 开发人员命令提示**中输入以下格式的 `vsixinstaller` 命令：

   `vsixinstaller /logFile:[file path to log file] [file path to Toolkit installation file]`

1. 将 `[file path to log file]` 替换为用于创建安装日志的文件名和目录的完整文件路径。使用您指定的文件路径和文件名的 `vsixinstaller` 命令示例类似于以下内容：

   `vsixinstaller /logFile:C:\Users\Documents\install-log.txt [file path to AWSToolkitPackage.vsix]`

1. 将 `[file path to Toolkit installation file]` 替换为 `AWSToolkitPackage.vsix` 所在目录的完整文件路径。

   包含 Toolkit 安装文件完整文件路径的 `vsixinstaller` 命令示例应类似于以下内容：

   `vsixinstaller /logFile:[file path to log file] C:\Users\Downloads\AWSToolkitPackage.vsix`

1. 检查以确保文件名和路径正确，然后运行 `vsixinstaller` 命令。

   完整 `vsixinstaller` 命令的示例类似于以下内容：

   `vsixinstaller /logFile:C:\Users\Documents\install-log.txt C:\Users\Downloads\AWSToolkitPackage.vsix`

## 安装其他 Visual Studio 扩展
<a name="setup-troubleshoot-extensions"></a>

如果您已获得安装日志文件，但仍无法确定安装过程失败的原因，请检查是否能够安装其他 Visual Studio 扩展。安装其他 Visual Studio 扩展可以进一步了解安装问题。如果您无法安装任何 Visual Studio 扩展，则可能需要改为排查 Visual Studio 的问题，而不是 AWS Toolkit for Visual Studio 的问题。

## 联系支持人员
<a name="setup-troubleshoot-contact"></a>

如果您已阅读本指南的所有部分，但仍需要其他资源或支持，则可以前往 [AWS Toolkit for Visual Studio Github Issues](https://github.com/aws/aws-toolkit-visual-studio/issues/) 站点查看过去的问题或提交新问题。

为了帮助加快问题的解决，请执行以下操作：
+ 查看过去和当前的问题，看看其他人是否遇到过类似的情况。
+ 详细记录您为解决问题而采取的每个步骤。
+ 保存您在安装 AWS Toolkit for Visual Studio 扩展或其他扩展时获得的所有日志文件。
+ 将您的 AWS Toolkit for Visual Studio 安装日志文件附在新问题中。