本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 故障診斷 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 Installer**。
1. 對 Visual Studio （受影響） 的安裝執行修復。這可讓 Visual Studio 重建其已安裝擴充功能的索引。
1. 在重新啟動 Visual Studio 之前重新啟動 Windows。
**如何尋找您的 AWS Toolkit 日誌**
1. 在 Visual Studio 主功能表中，展開**延伸模組**。
1. 選擇**AWS 工具組**以展開 AWS 工具組功能表，然後選擇**檢視工具組日誌**。
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 儲存庫中的[問題編號 452](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 Studio 執行個體安裝在相同系統上的網際網路瀏覽器導覽至 [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/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 執行時間上執行的語言伺服器。如需如何檢查網路是否使用自訂憑證的詳細資訊，請參閱《 第 1 版*AWS Command Line Interface*使用者指南[》中的 主題中的組態和憑證檔案設定 AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle)。
若要設定代理設定並定義憑證，您必須設定`HTTPS_PROXY`您的 env 變數，並為 `NODE_OPTIONS`和 `NODE_EXTRA_CA_CERTS`金鑰建立 Windows 環境變數。
若要設定您的 `HTTPS_PROXY` env 變數，請完成下列步驟。
1. 從 Visual Studio 主功能表選擇**工具**，然後選擇**選項**。
1. 從**選項**選單中，展開 **AWS Toolkit**，然後選擇 **Proxy**。
1. 從 **Proxy** 功能表中，定義您的**主機**和**連接埠**。
**注意**
如需`HTTPS_PROXY`從 設定 的相關資訊 AWS CLI，請參閱*AWS Command Line Interface*《 使用者指南》中的[針對 主題使用 HTTP 代理 AWS CLI](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`
**注意**
如需有關擷取公司根憑證的詳細資訊，請參閱在 https：//*learn.microsoft.com* 匯出[具有其私有金鑰的憑證](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key)文章。如需 Windows 環境變數金鑰的詳細資訊，請參閱 [Node.js v23.3.0 文件](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file)，網址為 https：//*nodejs.org*。
### 允許列出和其他步驟
除了干擾 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 Logs，並透過 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 組日誌的詳細資訊，請參閱本使用者指南主題的**疑難排解最佳實務**一節中的資訊。