C# 基礎語法規範：命名慣例、關鍵字、註解、類別與方法結構

良好程式碼始於規範

如同學習語言需遵循語法，C# 也有嚴格的命名規則與程式結構要求，讓程式碼易讀、易維護。

一、變數命名規則

• 由字母、數字、底線組成，不可數字開頭。
• 採用有意義的名稱：penPrice 優於 x。
• 慣例：區域變數/參數用 camelCase，公開成員用 PascalCase。

二、關鍵字保留字

if、else、for、while、class、public、static、void 等皆為保留字，不可作為識別項名稱。IDE 會以特殊顏色標示。

string public = "keyword"; // 編譯錯誤：'public' 是關鍵字

三、程式基本結構

using System;
using System.Collections.Generic;

namespace MyApp
{
    class Program
    {
        static void Hello()
        {
            Console.WriteLine("Hello!");
        }

        static void Main(string[] args)
        {
            Hello();
            // 單行註解
            /*
             * 多行註解
             */
        }
    }
}

關鍵規則

• 每行陳述式以 ; 結尾（英文分號）。
• 大括號 {} 成對出現，定義區塊範圍。
• 類別名、方法名首字母大寫（PascalCase）。
• 命名空間組織相關類別，避免名稱衝突。

四、方法定義語法

[修飾詞] 回傳型別 方法名(參數列表)
{
    // 方法主體
    return 值; // 若有回傳值
}

五、類別定義語法

public class Person
{
    // 欄位
    public string Name;
    private int _age;

    // 屬性
    public int Age
    {
        get { return _age; }
        set { _age = value; }
    }

    // 方法
    public void SayHello()
    {
        Console.WriteLine($"Hello, I'm {Name}");
    }
}

六、註解的重要性

• // 單行註解
• /* ... */ 多行註解
• /// XML 文件註解（可產生 API 文件）

良好的註解讓他人（與未來的自己）快速理解程式意圖。