簡介

  • 3 分鐘

您撰寫的程式碼應該會將您的意圖傳達給編譯器，以及其他可能必須讀取您程式碼的開發人員。 而且，由於您是最常讀取程式碼的開發人員，有時在您最初撰寫程式碼之後幾個月，最好撰寫清楚且容易瞭解的程式碼。 請記住，您可以撰寫程式碼一次，但您必須讀取多次。

假設您被要求為另一組開發人員撰寫一些程式碼。 您與他們會面並討論規格，指派就非常明確了。 會面後，他們會告訴您將在開發期間獨立工作。 完成後，您會將程式碼交給另一個群組。 程式碼撰寫工作不在您的技能等級之外，但您從不需要撰寫由其他人維護的程式碼。 小組會告訴您，只要您遵循 C# 的標準程式碼慣例，就不會有問題。 您制定計畫檢閱與即將處理之程式碼相關的 C# 程式碼撰寫慣例。

在本課程模組中，您將了解如何為描述其用途與意圖的變數選擇名稱。 您將了解如何新增程式碼註解以在程式碼中記載更高層級的需求與方法，並暫時指示編譯器忽略程式碼行。 最後，您將了解如何使用空白字元來協助傳達個別程式碼行的關聯性。

在此課程模組結束時，您將撰寫更有目的性的程式碼，並將重點放在程式碼的可讀性與品質，以便傳達給編譯器與其他開發人員。

重要

本課程模組包含需要 Visual Studio Code 的程式代碼撰寫活動。 您需要存取已針對 C# 應用程式開發安裝及設定 Visual Studio Code 的開發環境。

學習目標

在本單元中，您將：

  • 選擇描述其用途與意圖之變數的描述性名稱。
  • 使用程式碼註解，暫時指示編譯器忽略程式碼行。
  • 使用程式碼註解來描述程式碼片段較高層級的需求或用途。
  • 撰寫有效使用空白字元的程式碼，以傳達程式碼行的關聯性。

必要條件

  • 使用 Visual Studio Code 來建立和執行 C# 主控台應用程式的經驗。
  • 體驗使用 Console.WriteLine() 將訊息列印至主控台。
  • 體驗使用 if 和 else if 陳述式以建立程式碼分支。