# 【0-3】C++基本守則

和寫作文一樣，我們寫程式的時候也要注重「文法」、「格式」。

除了讓程式能正常運行以外，具備「可讀性」也是很重要的，不管是自己 debug 還是跟別人合作專案，都不希望看到代碼是亂七八糟的。

## 乾淨的代碼

#include <iostream>
#include <vector>
using namespace std;

int main() {
    vector<int> nums = {3, -1, 5, 0, -7, 8};
    int sum = 0;

    for (int i = 0; i < nums.size(); i++) {
        if (nums[i] > 0) {
            sum += nums[i];
        }
    }

    cout << "Total positive sum: " << sum << endl;
    return 0;
}

## 雜亂的代碼

#include<iostream>
#include<vector>
using namespace std;
int main(){        vector<int>a={3,-1,5,0,-7,8}    ;    int s=0;
    for(int i=0;i<a.size();i++){if(a[i]>0)    {s+=a[i];}}
           cout<<"Total positive sum:"<<s<<endl;}

通過這兩者的比較，應該能理解「文法」、「格式」的重要性了吧。雖然執行出來結果相同，但程式碼畢竟是給人看的，排版整潔乾淨能讓 coding 過程更順利。

## 規則

文法錯誤會導致程式無法執行；而格式錯誤雖不會影響程式運作，卻會大幅降低可讀性。良好的格式不只是為了「好看」，更能幫助自己除錯、維護，也方便他人閱讀與協作。

以下是撰寫 C++ 程式時應遵守的基本排版規則：

1. **每行結尾要加上「半形分號」（`;`）**，就像中文句子結尾的句號，才能正確分隔不同語句。
2. **所有括號都必須成對出現**，包括大括號 `{}`、小括號 `()`，否則容易造成編譯錯誤。
3. **每進入一層大括號內部，就要縮排 4 個空格（或按一次 Tab）**，讓程式結構層次更清楚。
4. **不同的語句（函數、符號、數字）間建議留一格空白**，讓程式碼不會擠在一起，提升可讀性。
5. **不同功能的區塊之間應留一空行**，就像段落換行一樣，方便快速理解整體邏輯。
6. **使用有意義的變數名稱**，例如 `sum`（總和）比 `s` 更清楚，`nums`（數字陣列）比 `a` 更具語意。
7. **一段程式最好只處理一個功能**，寫出來的程式就像有段落的文章，條理分明，也更容易維護。

---

聯絡方式：[e-mail]
最後編修時間：2025/06/22 子柚筆