了解如何搭配 C# 使用程式碼編輯器

發行項
10/05/2023

在這個 10 分鐘的 Visual Studio 程式碼編輯器簡介中，我們會將程式碼新增至檔案，以了解 Visual Studio 讓撰寫、導覽和了解 C# 程式碼更加輕鬆的一些方式。

如果您尚未安裝 Visual Studio，請前往 Visual Studio 下載頁面免費進行安裝。

本文假設您已熟悉 C#。如果您不熟悉 C#，我們建議您先瀏覽教學課程 (例如開始使用 Visual Studio 中的 C# 和 ASP.NET Core)。

提示

若要繼續遵循這篇文章，請確定您已為 Visual Studio 選取 C# 設定。如需選取整合式開發環境 (IDE) 的設定資訊，請參閱選取環境設定。

建立新的程式碼檔

從建立新檔案並在其中新增一些程式碼開始。

開啟 Visual Studio。在開始視窗中按 Esc 或按一下 [不使用程式碼繼續]，以開啟開發環境。
從功能表列的 [檔案] 功能表中，選擇 [新增]>[檔案]，或按下 Ctrl+N。
在 [新增檔案] 對話方塊的 [一般] 類別下，選擇 [Visual C# 類別]，然後選擇 [開啟]。

使用 C# 類別的基本架構，在編輯器中開啟新的檔案。 (請注意，我們不需要建立完整的 Visual Studio 專案，才能享有程式碼編輯器提供的一些優點，您只需要一份程式碼檔案！)

開啟 Visual Studio。在開始視窗中按 Esc 或選擇 [不使用程式碼繼續]，以開啟開發環境。
從功能表列的 [檔案] 功能表中，選擇 [新增]>[檔案]，或按下 Ctrl+N。
在 [新增檔案] 對話方塊的 [一般] 類別下，選擇 [Visual C# 類別]，然後選擇 [開啟]。

使用 C# 類別的基本架構，在編輯器中開啟新的檔案。您無須建立完整的 Visual Studio 專案，也可享有程式碼編輯器提供的一些優點，您只需要一份程式碼檔案。

使用程式碼片段

Visual Studio 提供實用的「程式碼片段」，讓您可以用來快速且輕鬆地產生常用的程式碼區塊。程式碼片段適用於不同的程式設計語言 (包括 C#、Visual Basic 和 C++)。

請在檔案中新增 C# void Main 程式碼片段。

請將游標放置在檔案中最後一個右大括號 } 的正上方，然後鍵入 svm 字元 (這表示 static void Main—若您不曉得其意義，請不用太擔心)。

快顯對話方塊出現，內有 svm 程式碼片段的相關資訊。
按兩次 Tab 鍵，以插入程式碼片段。

您會看到在檔案中新增 static void Main() 方法簽章。 Main() 方法是 C# 應用程式的進入點。

可用的程式碼片段會因不同的程式設計語言而異。您可以選擇 [編輯]>[IntelliSense]>[插入程式碼片段]，或按下 Ctrl+K、Ctrl+X，然後選擇您語言的資料夾，以查看程式設計語言的可用程式碼片段。針對 C#，清單如下：

Screenshot of an IntelliSense pop-up for a C# code snippet list.

請將游標放在檔案中最後一個右大括弧 } 的正上方，然後鍵入 svm 字元。 svm 代表 static void Main— 如果你還不知道這是什麼意思，別擔心。

快顯對話方塊出現，內有 svm 程式碼片段的相關資訊。
按兩次 Tab 鍵，以插入程式碼片段。

您會看到在檔案中新增 static void Main() 方法簽章。 Main() 方法是 C# 應用程式的進入點。

可用的程式碼片段會因不同的程式設計語言而異。您可以選擇 [編輯]>[IntelliSense]>[插入程式碼片段]，或按下 Ctrl+K, Ctrl+X，然後選擇程式設計語言的資料夾，以查看程式設計語言的可用程式碼片段。針對 C#，程式碼片段清單如下：

Screenshot of an IntelliSense pop-up for a C# code snippet list.

此清單包含的程式碼片段可用於建立類別、建構函式、for 迴圈、if 或 switch 陳述式等。

註解化程式碼

工具列是 Visual Studio 功能表列下的按鈕列，有助您提高撰寫程式碼的效率。例如，您可以切換 IntelliSense 完成模式 (IntelliSense 是程式碼撰寫的輔助工具，可顯示其他項目中符合的方法清單)，增加或減少行的縮排，也可以為不要編譯的程式碼加上註解。在本節中，我們會為一些程式碼加上註解。

Screenshot of the Editor toolbar in Visual Studio.

將下列程式碼貼入 Main() 方法主體。

// _words is a string array that we'll sort alphabetically
string[] _words = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] morewords = {
    "over",
    "the",
    "lazy",
    "dog"
};

IEnumerable<string> query = from word in _words
                            orderby word.Length
                            select word;

我們目前不會使用 morewords 變數，但之後可能會用到，所以我們不想要完全將其刪除。相反地，請將這些行註解化。選取 morewords 的整個定義，直到結尾分號為止，然後選擇工具列上的 [為所選行加上註解] 按鈕。如果您習慣使用鍵盤，請按 Ctrl+K、Ctrl+C。

C# 註解字元 // 會新增至每個選取行的開頭，以將程式碼註解化。

工具列是 Visual Studio 功能表列下的按鈕列，有助您提高撰寫程式碼的效率。例如，您可以切換 IntelliSense 完成模式、增加或減少行縮排，也可以為不要編譯的程式碼加上註解。

Screenshot of the Text Editor toolbar in Visual Studio 2022.

讓我們註解化一些程式碼。

將下列程式碼貼入 Main() 方法主體。

// someWords is a string array.
string[] someWords = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] moreWords = {
    "over",
    "the",
    "lazy",
    "dog"
};

// Alphabetically sort the words.
IEnumerable<string> query = from word in someWords
                            orderby word
                            select word;

我們不會使用 moreWords 變數，但稍後可能會使用它，因此不會想要將它刪除。相反地，讓我們將這些行註解化。選取 moreWords 的整個定義，直到結尾分號為止，然後選擇 [文字編輯器] 工具列上的 [為所選行加上註解] 按鈕。如果您習慣使用鍵盤，請按 Ctrl+E、Ctrl+C。

C# 註解字元 // 會新增至每個選取行的開頭，以將程式碼註解化。

摺疊程式碼區塊

我們不想要看到所產生的 Class1 具有空白建構函式，所以為了整理我們的程式碼檢視，讓我們將其摺疊。選擇建構函式第一行邊緣中其內有減號的小型灰色方塊。或者，如果您偏好使用鍵盤，請將游標放在建構函式程式碼中的任何位置，然後按 Ctrl+M、Ctrl+M。

程式碼區塊只會摺疊到第一行，並且後面接著省略符號 (...)。若要再次展開程式碼區塊，請按一下現在其內有加號的相同灰色方塊，或再次按 Ctrl+M、Ctrl+M。這項功能稱為大綱，而且特別適用於摺疊較長的方法或整個類別。

程式碼區塊只會摺疊到第一行，並且後面接著省略符號 (...)。若要再次展開程式碼區塊，請選取現在其內有加號的相同灰色方塊，或再次按下 Ctrl+M、Ctrl+M。這項功能稱為大綱，而且特別適用於摺疊較長的方法或整個類別。

檢視符號定義

Visual Studio 編輯器讓檢查類型、方法等等的定義變得十分輕鬆。其中一種方式是巡覽至包含定義的檔案，例如，在參考符號的任何位置選擇 [移至定義] 或按下 F12。不會將焦點移離所處理檔案的較快速方式是使用查看定義。讓我們查看 string 類型的定義。

以滑鼠右鍵按一下任何出現的 string，然後從內容功能表選擇 [查看定義]。或者，您也可以按 Alt+F12。

快顯視窗隨即出現，並內含 String 類別的定義。您可以在快顯視窗內捲動，或甚至查看已查看程式碼中另一種類型的定義。
選擇快顯視窗右上方含 "x" 的小型方塊，以關閉查看的定義視窗。

Visual Studio 編輯器讓檢查類型、方法或變數的定義變得十分輕鬆。其中一種方式是移至定義 (無論位於哪個檔案)，其做法是選擇 [移至定義]，或在參考符號的任何地方按下 F12。不會將焦點移開所處理程式碼的較快速方式是使用瞄核定義。

讓我們查看 string 類型的定義。

以滑鼠右鍵按一下任何出現的 string，然後從內容功能表選擇 [查看定義]。或者，您也可以按 Alt+F12。

快顯視窗隨即出現，並內含 String 類別的定義。您可以在快顯視窗內捲動，或甚至查看已查看程式碼中另一種類型的定義。
選擇快顯視窗右上方含 "x" 的小型方塊，以關閉瞄核定義視窗。

使用 IntelliSense 自動完成文字

IntelliSense 是您撰寫程式碼時的重要資源。它可以顯示類型可用成員的相關資訊，或方法之不同多載的參數詳細資料。在您鍵入足夠的字元來釐清文字之後，也可以使用 IntelliSense 自動完成文字。讓我們新增一行程式碼，將已排序的字串列印至主控台視窗，這是程式輸出的標準目標位置。

在 query 變數下方，開始鍵入下列程式碼：
```
foreach (string str in qu
```
您會看到 IntelliSense 示範 query 符號的 [快速諮詢]。
若要使用 IntelliSense 的文字完成功能來插入 query這個字的其餘部分，請按 Tab 鍵。
關閉程式碼區塊，使其看起來如下列程式碼。您甚至可以再次練習使用程式碼片段，方法是輸入 cw，然後按兩次 Tab 鍵以產生 Console.WriteLine 程式碼。
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

IntelliSense 是您撰寫程式碼時的重要資源。它可以顯示類型可用成員的相關資訊，或方法之不同多載的參數詳細資料。在您鍵入足夠的字元來釐清文字之後，也可以使用 IntelliSense 自動完成文字。

讓我們新增一行程式碼，將已排序的字串列印至主控台視窗，這是程式輸出的標準目標位置。

在 query 變數下方，開始鍵入下列程式碼：
```
foreach (string str in qu
```
您會看到所出現的 IntelliSense 快顯方塊包含 query 符號的相關資訊。
若要使用 IntelliSense 的文字自動完成功能來插入 query 這個字的其餘部分，請按下 Tab。
關閉程式碼區塊，使其看起來如下列程式碼。您可以進一步練習使用程式碼片段，方法是輸入 cw，然後按兩次 Tab 鍵以產生 Console.WriteLine 陳述式。
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

重構名稱

沒有人第一次就取得正確的程式碼，而且您可能想要變更的其中一個項目就是變數或方法的名稱。讓我們來試試看 Visual Studio 的重構功能，以將 _words 變數重新命名為 words。

將資料指標放在 _words 變數定義上方，然後從右鍵功能表或操作功能表中選擇 [重新命名]，或按 Ctrl+R、Ctrl+R。

快顯 [重新命名] 對話方塊會出現在編輯器右上方。
輸入所需名稱 words。請注意，也會自動重新命名查詢中 words 的參考。按 Enter 鍵之前，請選取 [重新命名] 快顯方塊中的 [包括註解] 核取方塊。
按 Enter。

出現的這兩個 words 已重新命名，以及程式碼註解中的 words 參考。

沒有人第一次就取得正確的程式碼，而且您可能想要變更的其中一個項目就是變數或方法的名稱。讓我們來試試看 Visual Studio 的重構功能，以將 someWords 變數重新命名為 unsortedWords。

將資料指標放在 someWords 變數定義上方，然後從右鍵功能表或操作功能表中選擇 [重新命名]，或按下 F2。

[重新命名] 對話方塊會出現在編輯器右上方。
輸入所需的名稱 unsortedWords。您會看見 query 指派陳述式中 unsortedWords 的參考也會自動重新命名。按 Enter 鍵之前，請選取 [重新命名] 快顯方塊中的 [包括註解] 核取方塊。
按下 Enter，或選擇 [重新命名] 對話方塊中的 [套用]。

您的程式碼中出現的這兩個 someWords 已重新命名，以及程式碼註解中的 someWords 文字。