首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> C語言 >> 關於C語言

個人 C 語言編程風格總結:文件管理、命名規則、表達式與文件編寫實戰規範

     編輯:關於C語言

前言

代碼質量直觀反映工程師水平。統一風格能大幅降低團隊協作溝通成本,本文從文件管理、命名、表達式、文件編寫四大維度闡述個人實踐規範。

一、文件管理

  • 純英文目錄路徑(避免中文/拼音導致工具鏈 BUG)。
  • 每專案獨立資料夾,IDE 工作區管理多專案。
  • 單一功能單一 Project,名稱精確反映內容。

二、命名規則

通用原則

  • 全英文,僅允許字母、數字、下劃線,禁用空格/特殊符號。
  • 見名知意,拒絕無意義縮寫(a,b,i 僅限迴圈計數)。

具體規範

對象風格範例
文件/資料夾全小寫,縮寫大寫flash_LED.c, UART.c
局部變數駝峰,小寫開頭,單詞height, sensorTemp
指標變數p_ 前綴 + 目標名p_height
全域變數模組名 + 功能名sensor_temperature, LCD_status
陣列單詞首字母大寫StringBuffer
函數主謂結構,下劃線分隔,模組_動作Delay_MS(), UART_TX(), REF_Set()
標號單詞小寫end_label
自定義類型單詞首字母大寫Student(類型),student(變數)
宏定義全大寫 + 下劃線MAX_ARRAY_LENGTH

三、表達式書寫

  • 運算符與操作數間加空格:a = a + b;
  • 善用括號消除優先級歧義,括號優先級最高。
  • 避免 a=-1 被誤解為 a = a - 1(舊版編譯器),寫 a = -1;。
  • 復合賦值符不可拆分:+= 不能寫 + =。

血淚教訓:a = a/*b; 被識別為註釋開頭,正確寫 a = a / *b; 或 a = a/(*b);。

四、文件編寫

模組化拆分原則

  • 函數超過幾十行 → 拆分子函數。
  • 文件超過幾百行 → 按模組拆文件。
  • 最佳依據:按模組劃分文件,按功能劃分函數。

.c vs .h 內容規範

.c 源文件.h 頭文件
#include 指令#include 指令
宏定義宏定義
所有函數定義(含函數體)內部函數聲明(static)
內部函數聲明(static)外部函數聲明(extern)
外部變數定義(賦初值)外部變數聲明(extern,不賦值)
靜態外部變數定義外部陣列聲明(const)
條件編譯條件編譯
自定義類型自定義類型

頭文件防重複包含

#ifndef __FILENAME_H__
#define __FILENAME_H__
// 內容
#endif

縮進與大括號風格

  • 統一 4 空格縮進。
  • 大括號風格兩種並存:
    ① int main() {(緊湊)
    ② int main()\n{(對齊明確)

函數註釋必寫

說明入口/出口參數、功能、注意事項,便於維護。

結語

規範非束縛,而是自由的前提。從今天起,用「給新手看」的標準審視每行代碼,專業習慣成就長遠職業生涯。

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved