高品質 C/C++ 程式設計指南：核心原則與實戰規範

前言

原文為空白模板，本文依業界公認最佳實踐（Google C++ Style Guide、C++ Core Guidelines、MISRA C++、Effective C++ 系列）重構核心指南，供團隊直接採納或客製化。

一、檔案組織與命名

二、命名約定

三、型別與資源管理

• RAII 原則：資源在建構函數獲取、解構函數釋放（智慧指標、容器、鎖、檔案句柄）
• 避免裸 new/delete：用 std::make_unique、std::make_shared、std::vector
• 避免裸指標擁有權：非擁有觀察用 T*、gsl::not_null、std::span
• Rule of Five/Zero：自訂拷貝/移動/解構 → 五個全寫；否則 =default 或 =delete
• 優先值語義：傳遞小型物件用值，大型用 const 參考，需修改用非 const 參考，所有權轉移用 &&

四、錯誤處理

• 異常用於錯誤：不可預期、無法局部處理的失敗（資源耗盡、前置條件違反）
• 錯誤碼/Expected 用於預期失敗：查找失敗、驗證錯誤、網路逾時
• 不使用 C 錯誤碼 (errno) 或 bool 返回值 傳遞豐富錯誤資訊
• noexcept 正確標註：移動建構、swap、解構函數必須 noexcept

五、並發與同步

• 優先不可變資料：const、值傳遞、無共享狀態
• 鎖粒度最小化：std::lock_guard/scoped_lock 保護最小臨界區
• 避免巢狀鎖：固定鎖順序、std::lock 多重鎖
• 無鎖僅用於專家級熱路徑：std::atomic、memory_order

六、現代 C++ 風格 (C++17/20)

• auto 配合尾端返回型別、結構化綁定
• constexpr 取代宏、編譯期計算
• std::optional 替代 nullptr/哨兵值
• std::variant 替代 union/型別碼
• std::string_view 替代 const string& 參數
• modules (C++20) 取代標頭檔包含
• concepts 限制模板參數

七、註解與文件化

• 檔案頭：版權、授權、簡述、作者、日期
• 公開 API：Doxygen 格式 /// @brief ... @param ... @return ...
• 實作細節：// Why: ... 解釋意圖，非重複代碼
• TODO/FIXME/NOTE 標準標籤

八、效能與優化

• **先正確、再清晰、最後快**
• 效能優化需 Profiling 數據支援，禁止過早優化
• 關注演算法複雜度、快取友好、分支預測、向量化
• 嵌入式/即時系統：MISRA C++、-fno-exceptions、-fno-rtti

九、工具鏈與自動化

• 格式化：clang-format 統一風格
• 靜態分析：clang-tidy、cppcheck、PVS-Studio
• 編譯警告：-Wall -Wextra -Wpedantic -Werror (CI 強制)
• 測試：GoogleTest / Catch2，覆蓋率 > 80%
• CI/CD：每提交自動建構、測試、分析、部署

十、總結

高品質 C/C++ 代碼的核心是：**嚴謹的資源管理 (RAII)、清晰的所有權語義、現代語法糖簡化邏輯、自動化工具守護品質**。本指南為基礎骨架，團隊應根據專案屬性（嵌入式/雲服務/遊戲/科學計算）裁剪擴充，並納入程式碼審查 (Code Review) 文化，持續演進。