針對 Visual Studio 安裝和升級問題進行疑難排解

發行項
01/07/2023

適用于：Visual StudioVisual Studio for MacVisual Studio Code

提示

遇到安裝問題嗎？我們可以幫您。我們提供僅英文) 支援選項的 安裝聊天 (。

此疑難排解指南包括逐步指示，應該可以解決大部分的安裝問題。

線上安裝

下列步驟適用于一般線上安裝。如需網路 (版面配置) 或離線安裝，請參閱如何針對離線安裝進行疑難排解。

步驟 1 - 檢查問題是否為已知問題

Visual Studio 安裝程式有一些已知問題，Microsoft 正在努力修正。若要查看是否有您問題的因應措施，請參閱版本資訊的＜已知問題＞一節。

Visual Studio 安裝程式有一些已知問題，Microsoft 正在努力修正。檢查您的問題是否已解決，或在版本資訊之 [已知問題] 區段中尋找因應措施。

步驟 2 - 嘗試修復 Visual Studio

修復修正許多常見的更新問題。如需何時以及如何修復 Visual Studio 的詳細資訊，請參閱修復 Visual Studio。

步驟 3 - 洽詢開發人員社群

在Visual Studio 開發人員社群中搜尋您的錯誤訊息。社群的其他成員可能已找到問題的解決方案或因應措施。

步驟 4 - 刪除Visual Studio 安裝程式資料夾以修正升級問題

Visual Studio 啟動載入器是一個輕量可執行檔，可起始Visual Studio 安裝程式和 Visual Studio 產品的安裝。刪除Visual Studio 安裝程式檔案，然後重新執行啟動載入器可解決一些更新失敗。

注意

執行下列動作將會重新安裝 Visual Studio 安裝程式檔案並重設安裝中繼資料。

關閉 Visual Studio 安裝程式。
刪除Visual Studio 安裝程式安裝目錄。此目錄通常是 C:\Program Files (x86)\Microsoft Visual Studio\Installer。
執行 Visual Studio 啟動載入器。您可以在 [下載] 資料夾中找到檔名遵循 vs_[Visual Studio edition]__*.exe 模式的啟動載入器。如果您找不到該應用程式，您可以移至 Visual Studio 較舊的下載頁面，然後按一下 Visual Studio 版本的 [ 下載 ] 來下載啟動載入器。接著，執行該可執行檔來重設您的安裝中繼資料。
嘗試重新安裝或更新 Visual Studio。如果安裝程式繼續失敗，請繼續進行回報問題步驟。

關閉 Visual Studio 安裝程式。
刪除Visual Studio 安裝程式資料夾。一般而言，資料夾路徑為 C:\Program Files (x86)\Microsoft Visual Studio\Installer 。
執行 Visual Studio 安裝程式啟動載入器。您可能會在 [下載 ] 資料夾中找到符合模式的檔案名 vs_[Visual Studio edition]__*.exe 啟動載入器。或者，您可以從 Visual Studio 下載頁面下載 Visual Studio 版本的啟動載入器。接著，執行該可執行檔來重設您的安裝中繼資料。
嘗試重新安裝或更新 Visual Studio。如果Visual Studio 安裝程式繼續失敗，請繼續進行回報問題步驟。

步驟 5 - 回報問題

在某些情況下，例如有損毀的檔案時，問題可能需要逐案例疑難排解。為了協助我們協助您，請遵循下列步驟：

收集您的安裝記錄檔。如需詳細資訊，請參閱如何取得 Visual Studio 安裝記錄檔。
開啟 Visual Studio 安裝程式，然後按一下 [回報問題] 以開啟「Visual Studio 意見反應」工具。
提供問題報告標題，並提供相關詳細資料。按一下 [下一步] 以移至 [附件] 區段，然後附加產生的記錄檔 (一般而言，該檔案位於 %TEMP%\vslogs.zip)。
按一下 [下一步] 以檢閱您的問題報告，然後按一下 [提交]。

收集您的安裝記錄檔。如需詳細資訊，請參閱如何取得 Visual Studio 安裝記錄檔。
開啟Visual Studio 安裝程式，然後選擇 [回報問題] 以開啟 Visual Studio 意見反應工具。
提供您的問題報告標題，並提供相關的詳細資料。 Visual Studio 安裝程式的最新安裝記錄檔會自動新增至問題報告的[其他附件] 區段。
選擇 [提交]。

步驟 6 - 移除 Visual Studio 安裝檔案

最後一個方法，您可以移除所有 Visual Studio 安裝檔案和產品資訊：

請遵循本文中的步驟：移除 Visual Studio 頁面。
重新執行Visual Studio 安裝程式啟動載入器。您可能會在 [下載 ] 資料夾中找到符合模式的檔案名 vs_[Visual Studio edition]__*.exe 啟動載入器。或者，您可以從 Visual Studio 下載頁面下載 Visual Studio 版本的啟動載入器。
嘗試重新安裝 Visual Studio。

步驟 7 - 復原

如果上述任何步驟都無法協助您成功升級 Visual Studio，您可以嘗試復原至您先前安裝的版本。在嘗試復原之前，請先深入瞭解 Visual Studio 中的復原功能。

注意

從 Visual Studio 2022 17.4 版開始，如果：

您尚未從版面配置安裝。
您的原始版本位於目前的通道 17.1.7 版或更新版本，或 17.0 Fall 2021 LTSC 通道 17.0.10 或更高版本。

您可以使用 Visual Studio 安裝程式或使用命令列復原至您先前安裝的版本。

使用Visual Studio 安裝程式復原

在電腦上啟動Visual Studio 安裝程式。
請在安裝程式中尋找您安裝的 Visual Studio 版本。接下來，選擇 [更多]，然後選擇 [復原至舊版]。
選取 [確定 ] 以確認您的選擇。

重要

如果您位於具有安全性合規性或軟體更新需求的組織中，復原可能會停用或復原嘗試。請連絡 IT 系統管理員以取得進一步的詳細資料。

步驟 8 - (選擇性) 與我們連絡

若上述步驟都無法協助您成功地安裝或升級 Visual Studio，請使用我們的即時聊天支援選項 (僅限英文) 與我們連絡以取得進一步的協助。

步驟 7 - (選擇性) 與我們連絡

若上述步驟都無法協助您成功地安裝或升級 Visual Studio，請使用我們的即時聊天支援選項 (僅限英文) 與我們連絡以取得進一步的協助。

網路設定或離線安裝

若要解決網路安裝的問題，請參閱安裝或使用 Visual Studio 時的錯誤碼或針對網路相關錯誤進行疑難排解。

系統管理員更新

系統可能會因為各種情況而無法正確套用系統管理員更新。如需詳細資訊，請參閱系統管理員更新疑難排解錯誤碼。

安裝記錄

安裝記錄可協助我們針對大部分的安裝問題進行疑難排解。當您在Visual Studio 安裝程式中使用回報問題來提交問題時，會自動將Visual Studio 安裝程式的最新安裝記錄新增至報表。

如果您連絡Microsoft 支援服務，系統可能會要求您使用Microsoft Visual Studio 和.NET Framework記錄收集工具收集設定記錄。記錄收集工具會收集來自 Visual Studio 所安裝之所有元件的安裝記錄，包括 .NET Framework、Windows SDK 及 SQL Server。它也會收集Visual Studio 安裝程式、Windows Installer 和系統還原的電腦資訊、Windows Installer 清查和 Windows 事件記錄檔資訊。

若要收集記錄檔：

下載工具。
開啟系統管理命令提示字元。
在儲存工具的資料夾中執行 Collect.exe 。
此工具會在 vslogs.zip 您的 %TEMP% 資料夾中產生檔案，通常位於 C:\Users\YourName\AppData\Local\Temp\vslogs.zip 。

注意

執行工具所用的帳戶，必須相同於執行失敗安裝所用的帳戶。如果使用不同的使用者帳戶來執行工具，請設定 –user:<name> 選項，以指定執行失敗安裝所用的使用者帳戶。如需其他選項與使用資訊，請從系統管理命令提示字元執行 Collect.exe -?。

安裝 WebView2 時發生問題

WebView2 是 Visual Studio 所需的元件，但貴組織的群組原則可以封鎖此元件的安裝。封鎖 WebView2 的安裝將會防止安裝 Visual Studio。

兩個原則可控制安裝 WebView2 的能力： Microsoft Edge 「安裝 (WebView) 」和 Microsoft Edge 'InstallDefault'。

• 如果已設定 Microsoft Edge「安裝 (WebView) 」原則，則會判斷是否可以安裝 WebView2。 • 如果未設定 Microsoft Edge 'Install (WebView) ' 原則，Microsoft Edge 'InstallDefault' 原則會決定是否可以安裝 WebView2。

注意

如果兩個原則都未設定，則貴組織允許安裝 WebView2。