做 Windows 客户端开发的同学迟早会遇到这么一个需求启动界面要显示当前操作系统版本某个功能要根据系统版本来决定是否开放或者用户报 bug 时要带上系统环境信息。网上搜一圈很多人丢给你一句“用 GetVersionEx 就行”真抄过来一跑发现 Windows 8.1 上显示成 Windows 8Windows 10/11 上显示成 Windows 6.2代码还没法反驳。这篇文章我就把 C 获取本机系统版本的完整逻辑捋一遍给出一个能直接编译运行的源码并且解释为什么有些看似能用的 API 其实不能用避免你在系统信息上报、软件安装包判断这类场景里再踩一遍坑。写这套代码的背景很简单我之前做的一个跨平台工具需要在上报日志里附带系统版本一开始图省事直接调GetVersionEx结果在用户机器上一堆错误数据。后来排查发现是微软的兼容性机制在捣乱——应用程序没有声明支持高版本系统时旧 API 会“说谎”。这事最坑的地方在于它不会报错只会悄悄给你一个错误数字。所以后来我把方案改成通过RtlGetVersion获取内核版本再配合注册表读取产品信息这才稳定下来。今天分享的就是这个最终方案代码结构很清晰新手也能直接看明白。1. 需求拆解与 API 选型1.1 为什么“读系统版本”不是一行代码的事很多人第一个想法就是系统版本不是有现成 API 吗为什么还要折腾问题在于“你想要的版本”和“系统告诉你的版本”经常不是同一个东西。拿 Windows 10 举例它的内核版本号是 10.0市场名称叫 Windows 10但很多老 API 会返回 6.2。Windows 11 更离谱内核大版本还是 10.0只是 build 号到了 22000 以上单看主版本号根本分不清 Windows 10 和 Windows 11。再加上 Windows 7 是 6.1、Windows 8.1 是 6.3早期 Windows 10 还有一堆内部版本单纯拿主版本号做判断很容易写出“看似正确、实则过两天就要改”的代码。换个角度想获取系统版本本质上不是调一个函数那么简单它存在三个层次内核版本号主版本号、次版本号、build 号这是最客观的底层数据市场版本名称Windows 7、Windows 10、Windows 11 这种用户能看懂的名字产品类型与版本号专业版、企业版、教育版、Server 版以及 21H2、22H2、23H2 这类功能更新标记。这三个层次需要不同来源的数据拼装。内核版本号可以用RtlGetVersion拿市场名称和产品类型则要结合 build 号判断再加上注册表补充。理解了这一点再看代码你就不觉得繁琐了。1.2 GetVersionEx 的“坑”与新方案GetVersionEx是大部分教程的首选它在一个OSVERSIONINFOEX结构里把主版本、次版本、build 号、SP 版本都填好了用起来确实方便。但 Windows 8.1 之后微软调整了它的行为如果程序没有在 manifest 里声明兼容 Windows 8.1/10/11系统就会把这个调用“降级”处理返回值固定在某个旧版本上。具体表现就是你在 Windows 10 上编译一个没有 manifest 的普通 Win32 程序GetVersionEx返回的主版本很可能就是 6.2。这不是 API 坏了而是微软有意为之目的是防止老程序因为版本判断错误而触发不该走的兼容逻辑。我以前在调试时见过不少代码在 Windows 10 上硬生生走 Windows 8 的老逻辑查到最后全是这个原因。绕开这个坑有三个办法在应用程序 manifest 里声明所有已知的兼容系统版本让GetVersionEx返回真实版本改调RtlGetVersion这个 API 在ntdll.dll里不受兼容性 manifest 影响读注册表里的CurrentBuildNumber和ProductName。我最后选了第二种作为主路径因为它最直接、不依赖 manifest也不依赖注册表的格式变化。RtlGetVersion是内核导出的接口给的数据是系统当前实际内核版本不会掺入“面向老程序的兼容性谎言”。1.3 数据从哪来RtlGetVersion 的回归RtlGetVersion其实不是什么新东西它在接口层面一直存在只不过普通应用层开发对它的使用频率不高。它位于ntdll.dll签名也很直接NTSTATUS NTAPI RtlGetVersion(PRTL_OSVERSIONINFOEXW lpVersionInformation);参数结构RTL_OSVERSIONINFOEXW的字段和OSVERSIONINFOEX几乎一致包括主版本、次版本、build 号、产品类型、Suite 掩码等。最关键的是它返回的是“真实”的系统版本不用你去猜系统给不给面子。不过直接用RtlGetVersion有个小门槛它不是kernel32.dll导出的正式 Win32 API很多项目头文件里不会自动声明链接时也容易报.lib找不到。我的做法是运行时用GetModuleHandleW拿到ntdll.dll再用GetProcAddress取函数指针彻底绕开编译期链接依赖。这样代码在 MSVC、MinGW、Clang 下都能编译不需要额外处理库文件。1.4 我的接口选型结论总结一下最后采用的组合方案内核数据源RtlGetVersion负责拿主版本、build 号、产品类型市场名称在主版本和 build 号基础上做映射避免只区分 10 还是 11还要兼容旧系统补充信息源读取注册表HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion下的ProductName、EditionID、DisplayVersion、CurrentBuildNumber把产品版本和功能更新信息补全。这套组合的好处是既有硬核的内核数字又有用户能看懂的版本名称还不用依赖任何第三方库或者 WMI 服务。WMI 也能实现类似功能但启动慢、权限要求多在纯客户端工具里属于“杀鸡用牛刀”。2. 核心流程与数据结构说明2.1 关键数据结构和函数签名这里有两个核心结构需要理解清楚。OSVERSIONINFOEXW是传统 API 使用的结构它的成员包括dwMajorVersion、dwMinorVersion、dwBuildNumber、dwPlatformId、wProductType等。RTL_OSVERSIONINFOEXW结构在布局上可以看作同一套字段的另一份拷贝所以函数指针声明可以直接用OSVERSIONINFOEXW代替也能正常工作。为了代码更规范我会把函数指针声明成using RtlGetVersionFn LONG(NTAPI*)(PRTL_OSVERSIONINFOEXW);动态加载的代码很简单核心点是要先把结构体dwOSVersionInfoSize字段填成结构体大小这一点很多人会漏。2.2 动态加载 ntdll 的原因为什么不用静态链接ntdll.lib两个原因。一是工具链兼容性。Visual Studio 的自带 SDK 里能找到ntdll.lib但 MinGW、老版本 gcc 环境不一定有。动态加载只要系统里存在ntdll.dll就能跑编译阶段不需要任何额外库。二是调用方式更干净。RtlGetVersion这类ntdll导出函数属于“半内部接口”直接链接虽然能用但总给人一种不正式的感觉。动态加载加一层函数指针所有调用都在我们自己的封装函数里发生将来要替换成其他 API改动面也很小。2.3 版本到名称的映射规则拿到数字后要把数字映射成用户能看懂的系统名称。这一块不能偷懒直接输出10.0.22621用户看不懂但只判断“大于 10”又不严谨。我用的规则是主版本 10、build 号大于等于 22000Windows 11主版本 10、次版本 0Windows 10主版本 6、次版本 3Windows 8.1主版本 6、次版本 2Windows 8主版本 6、次版本 1Windows 7主版本 5Windows XP / Server 2003。这个映射不是万能的比如 Windows Server 2022 的内核数字也是 10.0.20348但市场名是 Server。所以判断完通用名称后还要看wProductType是否为VER_NT_WORKSTATION如果是 0x0000002 以外的值说明不是工作站系统名称里应补充“Server”信息。2.4 注册表作为补充信息源注册表里能补充两类信息一类是产品名另一类是功能更新标记。ProductName通常形如Windows 10 ProEditionID是Professional、Enterprise这类机器可读标识CurrentBuildNumber是当前 build 字符串DisplayVersion是 Windows 11 开始出现的功能更新标记例如23H2。注意Windows 11 上有些键值会比较迷惑比如ProductName在某些版本里仍写成Windows 10 Pro所以不能用它作为判断系统大版本的依据只能用它补全产品类型。真正分系统大版本要用 build 号。读取注册表时要特别小心 32 位进程在 64 位系统上的重定向问题。普通情况用RegOpenKeyExW打开HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion没问题但在 32 位进程里系统可能会把路径重定向到Wow6432Node。为了避免读到错误分支要显式加上KEY_WOW64_64KEY标志。3. 源码实现与编译运行3.1 完整源码下面这段代码我在 Visual Studio 2022、Visual Studio 2019、MinGW-w64 下都编译过Windows 7 到 Windows 11 上测试过输出你可以直接复制用。#include windows.h #include winternl.h #include string #include iostream #include sstream #include vector #include algorithm #include cctype using RtlGetVersionFn LONG(NTAPI*)(PRTL_OSVERSIONINFOEXW); // 读取注册表字符串值 std::wstring RegQueryString(HKEY root, const std::wstring subKey, const std::wstring valueName) { HKEY hKey nullptr; LONG ret RegOpenKeyExW(root, subKey.c_str(), 0, KEY_READ | KEY_WOW64_64KEY, hKey); if (ret ! ERROR_SUCCESS) return L; wchar_t buf[512] {0}; DWORD type 0; DWORD size sizeof(buf); ret RegQueryValueExW(hKey, valueName.c_str(), nullptr, type, reinterpret_castBYTE*(buf), size); RegCloseKey(hKey); if (ret ! ERROR_SUCCESS || type ! REG_SZ) return L; return std::wstring(buf, size / sizeof(wchar_t) - 1); } // 通过 RtlGetVersion 获取真实内核版本 bool GetKernelVersion(OSVERSIONINFOEXW osvi) { HMODULE hNtdll GetModuleHandleW(Lntdll.dll); if (!hNtdll) return false; auto pfn reinterpret_castRtlGetVersionFn( GetProcAddress(hNtdll, RtlGetVersion)); if (!pfn) return false; RTL_OSVERSIONINFOEXW rtl {0}; rtl.dwOSVersionInfoSize sizeof(rtl); if (pfn(rtl) ! 0) return false; osvi.dwOSVersionInfoSize sizeof(osvi); osvi.dwMajorVersion rtl.dwMajorVersion; osvi.dwMinorVersion rtl.dwMinorVersion; osvi.dwBuildNumber rtl.dwBuildNumber; osvi.dwPlatformId rtl.dwPlatformId; osvi.wServicePackMajor rtl.wServicePackMajor; osvi.wServicePackMinor rtl.wServicePackMinor; osvi.wSuiteMask rtl.wSuiteMask; osvi.wProductType rtl.wProductType; osvi.szCSDVersion[0] L\0; return true; } // 把 ProductName 里的 “Windows 10 Pro” 去掉 “Windows” 前缀 std::wstring TrimEditionName(const std::wstring productName) { std::wstring key LWindows; size_t pos productName.find(key); if (pos std::wstring::npos) return productName; std::wstring result productName.substr(pos key.size()); size_t start result.find_first_not_of(L \t); if (start std::wstring::npos) return L; size_t end result.find_last_not_of(L \t); return result.substr(start, end - start 1); } // 根据内核版本号映射市场名称 std::wstring GetMarketingName(const OSVERSIONINFOEXW osvi) { bool isServer (osvi.wProductType ! VER_NT_WORKSTATION); if (osvi.dwMajorVersion 10) { if (osvi.dwBuildNumber 22000) { return isServer ? LWindows 11 Server : LWindows 11; } return isServer ? LWindows 10 Server : LWindows 10; } if (osvi.dwMajorVersion 6 osvi.dwMinorVersion 3) return LWindows 8.1; if (osvi.dwMajorVersion 6 osvi.dwMinorVersion 2) return LWindows 8; if (osvi.dwMajorVersion 6 osvi.dwMinorVersion 1) return isServer ? LWindows Server 2008 R2 : LWindows 7; if (osvi.dwMajorVersion 5) return LWindows Server 2003 / XP; return LWindows; } // 拼装最终版本字符串 std::wstring GetSystemVersionString() { OSVERSIONINFOEXW osvi {}; if (!GetKernelVersion(osvi)) return L获取失败; std::wstring productName RegQueryString( HKEY_LOCAL_MACHINE, LSOFTWARE\\Microsoft\\Windows NT\\CurrentVersion, LProductName); std::wstring displayVersion RegQueryString( HKEY_LOCAL_MACHINE, LSOFTWARE\\Microsoft\\Windows NT\\CurrentVersion, LDisplayVersion); std::wstring buildNumber RegQueryString( HKEY_LOCAL_MACHINE, LSOFTWARE\\Microsoft\\Windows NT\\CurrentVersion, LCurrentBuildNumber); std::wstringstream ss; ss GetMarketingName(osvi); std::wstring edition TrimEditionName(productName); if (!edition.empty()) { ss L edition; } if (!displayVersion.empty()) { ss L (Version displayVersion L); } if (!buildNumber.empty()) { ss L Build buildNumber; } else { ss L Build osvi.dwBuildNumber; } return ss.str(); } int main() { // 让控制台能正常显示中文不影响核心逻辑 SetConsoleOutputCP(CP_UTF8); std::wcout GetSystemVersionString() std::endl; return 0; }3.2 关键代码段逐段解读重点看GetKernelVersion。它先通过GetModuleHandleW(Lntdll.dll)拿到模块句柄这个函数不会增加模块引用计数但ntdll.dll是系统核心模块进程启动时必定已经加载所以不需要担心拿不到句柄或者使用时被卸载。接着用GetProcAddress取RtlGetVersion的函数地址。这里有个容易写错的细节函数名一定要用RtlGetVersion不要画蛇添足加W后缀。ntdll导出的就是这个名字不是RtlGetVersionW。调用前把rtl.dwOSVersionInfoSize设成结构体大小这是很多 Windows 版本接口的通用约定。别管你之前用没用过这类函数这里漏了会导致调用失败或返回不完整数据。调用成功后会得到一个 NTSTATUS0 表示成功其他数字代表失败。RegQueryString函数里最关键的是KEY_WOW64_64KEY。如果你做一个 32 位版本的工具放在 64 位 Windows 上跑不加这个标志就可能被注册表重定向到Wow6432Node从而读不到真实数据。项目里如果确定只有 64 位版本这个标志也不会带来副作用建议统一加上。3.3 编译方法VS / MinGW / CMake用 Visual Studio 编译最简单新建一个控制台应用项目把代码粘贴进去配置成 x64 或 x86 都可以直接按 F5。因为代码用的是动态加载不需要额外链接ntdll.lib只要项目默认链接kernel32.lib和advapi32.lib就够。实际上RegOpenKeyExW在advapi32.lib里Visual Studio 默认就会带上不用你手动操作。MinGW-w64 的编译命令同样干净g -stdc17 -O2 -o sysver.exe sysver.cpp -ladvapi32-ladvapi32是因为注册表 API 在 Advapi32 库中不加会报链接错误。winternl.h在 MinGW-w64 头文件里有不需要额外下载。如果用 CMake在CMakeLists.txt里记得链接 Advapi32cmake_minimum_required(VERSION 3.16) project(sysver) add_executable(sysver main.cpp) target_compile_features(sysver PRIVATE cxx_std_17) if(WIN32) target_link_libraries(sysver PRIVATE advapi32) endif()3.4 运行效果在 Windows 11 家庭版上运行输出类似Windows 11 家庭中文版 (Version 23H2) Build 22631在 Windows 10 专业工作站版上运行输出类似Windows 10 专业工作站版 Build 19045如果你把编译出的程序放到 Windows 7 上运行输出会带上 Service Pack 信息吗这里需要注意RtlGetVersion返回的是内核 build 号Windows 7 的 SP1 走的是wServicePackMajor字段。我上面这份代码没有把它加进输出字符串如果你要兼容老系统可以在GetSystemVersionString里检测osvi.wServicePackMajor是否大于 0然后把SP xx拼进去。这部分代码很简单我就没占用正文篇幅。4. 常见问题与踩坑实录4.1 为什么 GetVersionEx 总是返回 6.2这是高频问题了。即使你系统是 Windows 10只要程序没带兼容性 manifestGetVersionEx就可能返回 6.2。它不报错数据又是“真实的”很多刚入门的同学会怀疑人生甚至以为自己写错了。解决办法有两个一是换RtlGetVersion也就是本篇文章的方案二是在项目里加兼容性 manifest。manifest 里的supportedOS节点需要把 Windows 7、Windows 8、Windows 8.1、Windows 10 的 GUID 全部列上一旦声明了老 API 就会返回真实版本。但 manifest 也有限制某些动态加载的奇怪环境下不一定生效所以我还是推荐先解决数据源不要只靠 manifest 续命。4.2 ntdll.lib 链接错误与规避如果你在网上看到另一种写法直接声明extern C NTSTATUS NTAPI RtlGetVersion(...)并且链接ntdll.lib那在 MSVC 下可能没问题但换个编译器就可能找不到符号或者因为ntdll.lib版本不一致导致链接失败。我代码里的动态加载方案把这层麻烦全部消除了。GetModuleHandleW返回的句柄不需要释放GetProcAddress拿到函数指针之后直接调用整个过程只依赖ntdll.dll必定存在这个事实。对于跨编译器、跨 SDK 版本的工具项目这是最稳的写法。4.3 注册表读不到 64 位系统的信息如果你用 32 位进程跑在 64 位 Windows 上并且没写KEY_WOW64_64KEY那么RegOpenKeyExW打开HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion时实际会被重定向到HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows NT\CurrentVersion。那个分支下不是没有值而是值不完整或版本信息错乱。所以不要觉得“读注册表很简单随便打开就能读”。凡是可能被兼容层重定向的注册表路径都要显式指定视图标志。KEY_WOW64_64KEY是告诉系统“我要访问 64 位视图”而KEY_WOW64_32KEY则是访问 32 位视图。代码里统一用 64 位视图数据最完整。4.4 在旧系统上编译/运行的问题RtlGetVersion在 Windows 7 上也是可用的因为ntdll.dll一直导出这个函数。用GetProcAddress动态加载时就算系统里没有这个导出函数代码也会安全返回false不会崩溃。不过 Windows 7 上注册表里的DisplayVersion字段不存在我的RegQueryString会返回空字符串输出就是正常的Windows 7 Build 7601没有多余信息表现符合预期。要注意的另一点是std::wstringstream和std::wcout在旧版 MSVC 上需要用/Zc:wchar_t-之类的情况很少见现代工具链基本没有这个问题。如果你在 Windows 7 上跑记得系统得装了对应的 VC 运行库否则启动直接报缺 DLL。4.5 安全性和权限补充这个方案读注册表用的是HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion普通用户权限就可以读取不需要管理员权限。RtlGetVersion也不需要任何提权因为它只是查询内核信息。如果你的工具运行在低权限沙箱进程中GetModuleHandleW和GetProcAddress不会受影响RegOpenKeyExW一般也能读因为当前版本信息键对普通用户是开放的。真遇到被安全软件拦得特别死的情况可以加一个 fallback直接用GetVersionEx和 manifest 搭配反正不会比没有信息更差。5. 扩展方向5.1 判断 Windows 11 和市场版本号Windows 11 的判断规则现在还算稳定主版本 10.0 build 大于等于 22000。这个数字在后续版本里可能会继续涨但不会低于 22000。我不建议用注册表DisplayVersion来区分 Windows 10 和 11因为 Windows 10 的某些较新系统镜像里也可能出现这个字段用它判断只会增加混乱。如果你想在界面上显示更友好的“Windows 11 22H2”这种样式直接读取DisplayVersion就够。实测在 Windows 11 上该字段通常返回22H2、23H2这类功能更新版本号在 Windows 10 上有时返回空这不影响主逻辑。5.2 区分 Windows Server上面代码已经做了基本处理如果wProductType不是VER_NT_WORKSTATION市场名称会拼上Server字样。但你如果做服务器监控工具可能还想知道具体是什么版本这里可以再读一个注册表值InstallationType它会返回Client或Server配合EditionID能拼出Windows Server 2022 Standard这类完整名称。这类信息在运维工具里很常用比如判断远程机器是服务器还是工作站决定是否加载某些图形组件。我自己的项目里就是在GetSystemVersionString的基础上又加了一个GetSystemRole函数逻辑完全独立不影响版本主流程。5.3 与其他方法的互补有人会问既然 WMI 能拿系统版本为什么不直接用它WMI 在某些场景确实能拿到更丰富的软硬件环境但它需要 WMI 服务运行正常第一次调用可能要一两秒在某些精简版系统里服务还可能被禁用。对于“进程启动时快速打印系统版本”这种轻量需求直接读内核 API 加注册表更合适。如果你以后需要更详细的系统信息比如 BIOS 版本、主板型号可以把这段代码作为快速路径保留再接 WMI 作为慢速补充。两个方案的输出可以缓存到同一个全局变量里避免重复查询。拿到这份代码之后建议你直接把它封装成一个GetSystemVersionString函数扔进自己的公共工具库。以后再遇到日志上报、版本判断、安装包启动前的环境检查都不用再临时翻资料了。C 来来回回就是这些细节放过那个GetVersionEx早换早清爽。