MSVC 預編譯指令詳解：_MSC_VER 版本判斷與 #pragma once 防重復包含機制

代碼原文與含義

#if _MSC_VER > 1000
#pragma once
#endif

• _MSC_VER：Microsoft C/C++ 編譯器版本號宏。
  • MS = Microsoft，C = C編譯器，VER = Version
  • VC++ 6.0 → 1200，VS2003 → 1310，VS2005 → 1400，VS2019 → 1920，VS2022 → 1930+
• _MSC_VER > 1000：判斷編譯器版本是否**高於 VC++ 5.0**（版本 1100）。
• #pragma once：告訴編譯器**「本文件在一次編譯過程中只被包含一次」**，替代傳統 #ifndef/#define/#endif 防衛宏。

為什麼要版本判斷？

早期 MSVC（≤5.0）**不支援** #pragma once。若無條件使用，舊版編譯器會報錯或忽略，導致頭文件重復包含引發重定義錯誤。版本判斷實現「新編譯器享受高效機制，舊編譯器回退傳統防衛宏」。

標準頭文件雙重保護模板

// MyHeader.h
#if _MSC_VER > 1000
#pragma once  // MSVC 專用，編譯速度快（無需再次打開文件掃描）
#endif

#ifndef __MYHEADER_H__  // 標準 C/C++ 通用防衛宏，兜底
#define __MYHEADER_H__

// ... 聲明內容 ...

#endif // __MYHEADER_H__

#pragma once vs 防衛宏：性能與可移植性權衡

常見誤區

• 誤區：_MSC_VER 代表 Visual Studio 版本。
  正確：它代表 **C/C++ 編譯器 (cl.exe) 版本**。同一 VS 版本不同工具集（v140/v141/v142/llvm）對應不同 _MSC_VER。
• 誤區：#pragma once 能完全替代防衛宏。
  正確：跨平台項目、符號鏈接場景仍需防衛宏兜底。

查看當前 _MSC_VER 值

// test_ver.c
#include <stdio.h>
int main() {
    printf("_MSC_VER = %d\n", _MSC_VER);
    return 0;
}

在 MSVC 開發者命令提示行編譯運行，即可獲取當前編譯器版本號。