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

適用于:是Visual Studio否Visual Studio for Mac否Visual 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 安裝程式檔案並重設安裝中繼資料。

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

步驟 5 - 回報問題

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

  1. 收集您的安裝記錄檔。 如需詳細資訊,請參閱如何取得 Visual Studio 安裝記錄檔
  2. 開啟 Visual Studio 安裝程式,然後按一下 [回報問題] 以開啟「Visual Studio 意見反應」工具。 顯示Visual Studio 安裝程式中 [提供意見反應] 按鈕的螢幕擷取畫面。
  3. 提供問題報告標題,並提供相關詳細資料。 按一下 [下一步] 以移至 [附件] 區段,然後附加產生的記錄檔 (一般而言,該檔案位於 %TEMP%\vslogs.zip)。
  4. 按一下 [下一步] 以檢閱您的問題報告,然後按一下 [提交]
  1. 收集您的安裝記錄檔。 如需詳細資訊,請參閱如何取得 Visual Studio 安裝記錄檔
  2. 開啟Visual Studio 安裝程式,然後選擇 [回報問題] 以開啟 Visual Studio 意見反應工具。 顯示Visual Studio 安裝程式中 [提供意見反應] 按鈕的螢幕擷取畫面。
  3. 提供您的問題報告標題,並提供相關的詳細資料。 Visual Studio 安裝程式的最新安裝記錄檔會自動新增至問題報告的[其他附件] 區段。
  4. 選擇 [提交]

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

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

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

步驟 7 - 復原

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

注意

使用 Visual Studio 2022 17.4,您將能夠回復至您先前安裝的版本。

  • 針對發行通道,如果版本是 17.0.10 或更新版本,或 17.1.7 或更高版本,您可以復原至先前安裝的版本。
  • 針對預覽通道,如果版本是 17.2 Preview 1 或更新版本,您可以復原至先前安裝的版本。

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

使用Visual Studio 安裝程式復原

  1. 在電腦上啟動Visual Studio 安裝程式

  2. 請在安裝程式中尋找您安裝的 Visual Studio 版本。 接下來,選擇 [更多],然後選擇 [復原至舊版]。

    [回復至舊版] 選項的螢幕擷取畫面。

  3. 選取 [確定 ] 以確認您的選擇。

重要

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

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

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

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

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

網路設定或離線安裝

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

當您從網路或本機配置建立 離線安裝 並安裝時,可能會協助您的其他已知問題和因應措施。

問題 解決方法
使用者無法存取檔案 請確定您調整 ACL (ACL 的許可權) ,以便在共用離線安裝之前,將讀取許可權授與其他使用者。
無法安裝新的工作負載、元件或語言套件 如果您從部分配置安裝,而且如果您選取先前未針對該部分配置下載的工作負載、元件或語言,請確定您具有網際網路存取權。

系統管理員更新

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

安裝記錄

安裝程式記錄可協助我們針對大部分的安裝問題進行疑難排解。 當您使用 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 事件記錄檔資訊。

若要收集記錄檔:

  1. 下載工具
  2. 開啟系統管理命令提示字元。
  3. 在儲存工具的 資料夾中執行 Collect.exe
  4. 此工具會在 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。