如何:在 Visual Studio 中執行 C# 程式

適用于:是Visual Studio否Visual Studio for Mac否Visual Studio Code

如何執行程式取決於您從開始的內容、程式類型,以及是否要在偵錯工具下執行。 在最簡單的情況下,若要在 Visual Studio 中建置和執行開啟的專案:

  • F5,從 VisualStudio 功能表選擇 > [開始偵錯] 以偵錯,或選取 Visual Studio 工具列上的綠色 [開始]箭號和專案名稱。
  • 或者,若要在沒有偵錯的情況下執行,請按Ctrl+F5,或從 Visual Studio功能表選擇> [偵錯開始但不偵錯]。

顯示 [開始] 按鈕的螢幕擷取畫面。

顯示 [開始] 按鈕的螢幕擷取畫面。

從專案開始

如果是可執行檔程式,您可以執行 C# 專案或 .csproj 檔案。 如果專案包含具有 Main 方法的 C# 檔案,且其輸出為可執行檔或 .exe 檔案,則如果建置成功,可能會執行。 較新版本的 C# 不需要 Main 方法;相反地,程式執行會從最上層語句開始。 請參閱 沒有 Main 方法的程式

  1. 如果您的程式碼已經在 Visual Studio 專案中,請開啟專案。 若要這樣做,您可以按兩下或點選 Windows 檔案總管中的.csproj檔案,或選擇在 Visual Studio 中開啟專案、流覽以尋找.csproj檔案,然後選取檔案。

  2. 在 Visual Studio 中載入專案之後,如果您的 Visual Studio 方案有多個專案,請務必使用 Main 方法將專案設定為啟始專案。 若要設定啟始專案,請以滑鼠右鍵按一下方案總管中的專案名稱或節點,然後從操作功能表中選擇 [設定為啟始專案]。

    顯示設定啟動專案的螢幕擷取畫面。

    顯示設定啟動專案的螢幕擷取畫面。

  3. 若要執行程式,請按Ctrl+F5,從頂端功能表中選取 > [偵錯開始但不偵錯],或選取綠色的 [開始]按鈕。

    Visual Studio 會嘗試建置和執行您的專案。 在 Visual Studio 畫面底部,組建輸出會出現在 [ 輸出 ] 視窗中,而任何建置錯誤都會出現在 [ 錯誤清單 ] 視窗中。

    如果建置成功,應用程式會視專案類型執行。 主控台應用程式會在終端機視窗中執行,Windows 傳統型應用程式會在新的桌面視窗中啟動,而 Web 應用程式會在由 IIS Express 裝載的瀏覽器中執行。

從程式碼開始

如果您從程式代碼清單、程式碼檔案或少量的檔案開始,請先確定程式碼是受信任的來源可執行檔程式。 任何具有 Main 方法的應用程式可能都是可執行檔程式,但使用目前版本的 C# 時,沒有 Main 具有最上層語句之方法的程式也可以執行。 您可以使用主控台應用程式範本來建立專案,以在 Visual Studio 中使用應用程式。

單一檔案的程式代碼清單

  1. 啟動 Visual Studio,然後開啟空的 C# 主控台應用程式專案。
  2. 以程式代碼清單或檔案的內容取代專案 .cs 檔案中的所有程式碼。
  3. 將專案 .cs 檔案重新命名為符合程式碼檔案名。

磁片上的數個程式代碼清單或檔案

  1. 啟動 Visual Studio,並建立適當類型的新專案。 如果您不確定,請使用 C# 主控台應用程式
  2. 在新專案中,將專案程式碼檔中的所有程式碼取代為您第一個程式代碼清單或檔案的內容。
  3. 重新命名專案程式碼檔,以符合您的程式碼檔案名。
  4. 針對每個剩餘的程式碼檔案:
    1. 以滑鼠右鍵按一下方案總管中的專案節點,然後選擇 [新增>現有專案],或選取專案,然後按Shift+Alt+A
    2. 流覽至 並選取程式碼檔案,以將其匯入專案中。

資料夾中的數個檔案

如果您有包含許多檔案的資料夾,請先檢查項目或方案檔。 Visual Studio 所建立的程式具有專案和方案檔。 在 Windows 檔案總管中,尋找副檔名為 .csproj.sln的檔案。 按兩下 .csproj 檔案,在 Visual Studio 中加以開啟。 請參閱 從 Visual Studio 方案或專案開始

如果程式碼來自另一個開發環境,則沒有任何專案檔。 在 Visual Studio 中選擇 [開啟資料夾]> 以開啟資料夾。 請參閱 開發不含專案或解決方案的程式碼

從 GitHub 或 Azure DevOps 存放庫開始

如果您想要執行的程式碼位於 GitHub 或 Azure DevOps 存放庫中,您可以使用 Visual Studio 直接從存放庫開啟專案。 請參閱 從存放庫開啟專案

執行程式

若要開始建置程式,請按 Visual Studio 工具列上的綠色 [開始] 按鈕,或按F5Ctrl+F5。 使用 [ 開始] 按鈕或 F5 會在偵錯工具下執行程式。

Visual Studio 會嘗試在專案中建置和執行程式碼。 如果建置不成功,請參閱下列各節,以取得如何成功建置專案的一些想法。

疑難排解

您的程式碼可能有錯誤。 或者程式碼可能正確,但可能取決於遺漏的元件或 NuGet 套件,或以不同版本的 .NET 為目標。 在這些情況下,您可能可以輕鬆地修正組建。

新增參考

若要正確建置,程式碼必須正確,且具有程式庫或其他相依性的正確參考。 在編譯和執行程式之前, 錯誤清單中的 程式碼或專案中的紅色波浪線會顯示錯誤。 如果錯誤與未解析的名稱相關,您可能需要新增參考或 using 指示詞,或兩者。 如果程式碼參考任何遺漏的元件或 NuGet 套件,您必須將這些參考新增至專案。

Visual Studio 會嘗試協助您識別遺漏的參考。 當名稱無法解析時,燈泡圖示會出現在編輯器中。 選取燈泡以查看如何修正問題的建議。 修正可能是:

  • 新增 using 指示詞。
  • 將參考加入元件。
  • 安裝 NuGet 套件。

新增 using 指示詞

以下是遺漏 using 指示詞的範例。 您可以將 新增 using System; 至程式碼檔案的開頭,以解析未解析的名稱 Console

用來新增 using 指示詞的燈泡螢幕擷取畫面。

用來新增 using 指示詞的燈泡螢幕擷取畫面。

較新版本的 C# 支援某些常用命名空間的隱含 using 指示詞,因此如果您在建立專案時選擇該選項,就不需要它們。

新增元件參考

.NET 參考可以是元件或 NuGet 套件。 在原始程式碼中,發行者或作者通常會說明程式碼所需的元件,以及其相依的套件。 若要手動新增專案的參考,請以滑鼠右鍵按一下方案總管中的 [參考] 節點,然後選擇 [新增參考]。 在 [參考管理員] 中,找出並新增必要的元件。

[新增參考] 功能表的螢幕擷取畫面。

[新增參考] 功能表的螢幕擷取畫面。

您可以依照 使用參考管理員新增或移除參考中的指示,找到元件並新增參考。

新增 NuGet 套件

如果 Visual Studio 偵測到遺漏的 NuGet 套件,就會顯示燈泡,並提供安裝套件的選項:

用來安裝 NuGet 套件的燈泡螢幕擷取畫面。

用來安裝 NuGet 套件的燈泡螢幕擷取畫面。

如果這無法解決問題,或 Visual Studio 找不到套件,請嘗試線上搜尋套件。 請參閱 在 Visual Studio 中安裝和使用 NuGet 套件

使用正確的 .NET 版本

因為不同版本的.NET Framework有一些回溯相容性,所以較新的架構可能會執行針對較舊架構撰寫的程式碼,而不會進行任何變更。 但有時候您需要以特定.NET Framework版本為目標。 您可能需要安裝特定版本的 .NET Framework 或 .NET Core。 請參閱 修改 Visual Studio

若要變更目標.NET Framework版本,請參閱變更目標架構。 如需詳細資訊,請參閱針對目標錯誤進行疑難排解.NET Framework

下一步