C 語言單鏈表創建報錯：函數聲明與定義參數類型不匹配完整解析

錯誤信息

error C2664: 'traverse_list' : cannot convert parameter 1 from 'struct Node *' to 'struct Node'

代碼片段

// 聲明
void traverse_list(NODE pHead);  // NODE 即 struct Node

// 定義
void traverse_list(PNODE pHead)  // PNODE 即 struct Node *
{ ... }

// 調用
PNODE pHead = create_list();
traverse_list(pHead);  // 傳遞指針

根本原因

函數聲明參數類型為 NODE（結構體值傳遞），而定義與調用均使用 PNODE（指針傳遞）。編譯器根據聲明進行類型檢查，發現實參 struct Node * 無法隱式轉換為 struct Node，故報錯。

修正方案

統一聲明、定義、調用的參數類型為指針：

// 正確聲明
void traverse_list(PNODE pHead);  // 或 void traverse_list(struct Node *pHead);

最佳實踐建議

• 習慣在頭文件中統一聲明，源文件包含頭文件實現，避免聲明定義分離導致不一致。
• 使用 typedef struct Node *PNODE; 後，優先使用 PNODE 表達指針語義，減少 struct Node * 直接出現。
• 啟用編譯器警告 -Wall -Wextra（GCC/Clang）或 /W4（MSVC），可在編譯期捕獲此類不匹配。

補充：單鏈表創建的常見邏輯錯誤

原代碼採用頭插法，導致節點順序與輸入順序相反。若需保持順序，請改用尾插法：

PNODE pTail = pHead;
for (...) {
    PNODE pNew = malloc(sizeof(NODE));
    pNew->data = val;
    pNew->pNext = NULL;
    pTail->pNext = pNew;
    pTail = pNew;
}