風格指南旨在統一編碼規範,讓團隊專注於實作而非格式爭辯。但**所有優秀規則皆允許例外**,核心原則是**一致性**(包含既有程式碼的一致性)。
修改他人程式碼時,優先遵循**原有風格**以保持檔案內部一致。必要時與原作者或負責人溝通確認。
Windows 程式設計師有獨特習慣(源自 Windows SDK 樣式),但跨平台專案需統一風格。以下為 Windows 程式碼在 Google 風格下的強制調整項:
.cc 而非 .cpp。const TCHAR* 替代 LPCTSTR,僅在呼叫 Windows API 時使用 DWORD、HANDLE 等別名。#pragma once:使用標準 Include Guard,路徑包含專案頂層(如 #include <project/public/tools.h>)。#pragma、__declspec 等僅在萬不得已時使用,DLL 匯出入巨集化(DLLIMPORT/DLLEXPORT)以利跨平台移除。_ATL_NO_EXCEPTIONS 禁用 ATL 異常;若需 STL 異常可開啟編譯器選項,**但自身程式碼嚴禁撰寫異常處理邏輯**。#include "StdAfx.h",改用編譯器 /FI 選項強制包含(precompile.cc 除外)。resource.h 僅含巨集定義,不受風格指南約束。參考常識,保持一致。
if 後加空格,你也加;若註解用星號圍成盒子,你也照做。風格指南到此告一段落。**程式碼本身才是更有趣的**,盡情享受寫代碼的樂趣吧!