C 語言初學者在 Visual Studio / Code::Blocks / Dev-C++ 中常遇到「多重定義 main」「鏈接錯誤 LNK2005」「makefile 錯誤」等問題。本文以實戰案例拆解核心原因，提供標準化專案結構與編碼規範模板，助你告別編譯報紅。
main()error LNK2005: _main 已經在 main.obj 中定義
error LNK1169: 找到一個或多個多重定義的符號
main.c、test.c、homework.c 等多個 .c 文件，每個文件都寫了 int main()。main。編譯器將每個 .c 獨立編譯為 .obj，鏈接器發現多個 main 符號衝突。| 方案 | 適用場景 | 操作步驟 |
|---|---|---|
| 方案 A：單文件練習 | 每個練習獨立運行 | 專案中只保留一個含 main() 的 .c 文件，其他文件從專案中「排除」（右鍵 → Properties → Exclude from Build）或移出專案目錄 |
| 方案 B：多文件協作 | 模塊化編程、函數庫 | 只有一個 main.c 含 main()；其他 .c 只寫函數實現，配套 .h 聲明；main.c #include "other.h" 調用 |
| 方案 C：多個可執行文件 | 同一目錄下多個獨立程序 | 使用 CMake / 多專案解決方案 / 手寫 Makefile 為每個可執行文件指定唯一入口源文件 |
右鍵專案 → Properties → C/C++ → General → Additional Include Directories 添加頭文件路徑。無需手寫 Makefile。
# Makefile
CC = gcc
CFLAGS = -Wall -Wextra -std=c11 -g
TARGET = myapp
SRCS = main.c utils.c math.c
OBJS = $(SRCS:.c=.o)
all: $(TARGET)
$(TARGET): $(OBJS)
$(CC) -o $@ $^
%.o: %.c
$(CC) $(CFLAGS) -c $< -o $@
clean:
rm -f $(OBJS) $(TARGET)
.PHONY: all clean
SRCS 只列出一個含 main() 的文件（如 main.c）。.c 只實現函數，不含 main()。-Wall -Wextra 開啟全警告，-std=c11 鎖定 C11 標準。| 項目 | 錯誤示範 | 正確示範 | 原因 |
|---|---|---|---|
| main 返回值 | void main() / 無 return | int main(void) { ... return 0; } | C 標準要求 main 返回 int，0 表成功，非 0 表失敗 |
| for 循環大括號 | for(i=0;i<10;i++) printf("%d",i); | for(i=0;i<10;i++) { printf("%d",i); } | 防止後續加語句導致邏輯錯誤，統一風格 |
| 格式化輸出匹配 | int x; scanf("%f", &x); / printf("%f", x); | int x; scanf("%d", &x); printf("%d", x); | %d 對應 int，%f 對應 float/double，不匹配導致未定義行為 |
| scanf 取地址 | scanf("%d", x); | scanf("%d", &x); | 必須傳變量地址，否則修改隨機內存導致崩潰 |
| 變量初始化 | int x; if(x>0)... | int x = 0; ... | 未初始化變量值不定，邏輯判斷不可靠 |
| 緩衝區溢出 | char s[10]; scanf("%s", s); | char s[10]; scanf("%9s", s); | 限制寬度防止溢出，或用 fgets |
static 或移至單一 .c，頭文件只 extern 聲明 |
| C2065 / 未聲明標識符 | 變量/函數未聲明 | 漏 #include、拼寫錯誤、作用域外 | 補全頭文件、檢查拼寫、調整作用域 |
| C4700 / 未初始化變量 | 使用未初始化局部變量 | int x; printf("%d", x); | 定義時初始化 int x = 0; |
| C6001 / 緩衝區溢出 | 字符串複製越界 | strcpy(dest, src); 無長度檢查 | 用 strncpy/snprintf、或 strcpy_s (MSVC) |
| LNK2019 / 未解析外部符號 | 函數聲明了但未定義 | 只寫頭文件聲明，缺 .c 實現 | 補齊實現文件並加入專案編譯 |
C 語言初學者 90% 的編譯錯誤源於專案結構不清（多 main）與基礎語法不規範（格式符、初始化、大括號）。建立「一個專案一個 main、多文件分離聲明實現、警告全開、規範先行」的肌肉記憶，編譯報錯將減少 80% 以上。遇到報錯先看錯誤代碼、再定位行號、最後對照上表修復，養成獨立解決問題的能力。
