平台工具集和Windows SDK版本必须显式确认匹配，否则易致C1083或LNK2001错误；应选已安装稳定版本（如v145配10.0.22621.0），避免“最新版本”，并优先使用宏变量配置路径以保障可移植性。
平台工具集和 Windows SDK 版本必须显式确认
新建项目后，平台工具集 和 Windows SDK 版本 通常会加粗显示，说明它们不是继承自全局默认值——这容易导致后续编译失败或链接异常，尤其在团队协作或切换 VS 版本时。
常见错误现象：编译报错 C1083: 无法打开包括文件: “windows.h”，或链接时报 LNK2001: 无法解析的外部符号 __imp__...。
- 务必在「配置属性 → 常规」中检查
平台工具集是否为当前安装版本对应的值（如 VS 2022 对应v143，VS 2026 Insider 对应v145） -
Windows SDK 版本应选已安装且稳定的版本（如10.0.22621.0），避免选“最新版本”——它可能尚未随 VS 安装完成 - 若项目需长期维护，建议将二者都设为“从父级或项目默认设置继承”，再手动覆盖为确定可用的组合
C++ 语言标准和运行时库不匹配会引发隐性崩溃
默认生成的项目常设为 /MDd（多线程调试 DLL），但若代码中用了 std::filesystem 或 std::span 等 C++17+ 特性，而语言标准仍为 C++14，编译器不会报错，但运行时可能因 ABI 不一致而崩溃。
典型场景：调用第三方库（如 Boost.Filesystem）时，std::string 的内部布局与库期望不符，导致访问越界或空指针解引用。
立即学习“C++免费学习笔记（深入）”；
- 在「配置属性 → 常规」中统一设置
C++ 语言标准为ISO C++17 标准或更高（如C++20） - 在「配置属性 → C/C++ → 代码生成」中确认
运行时库：调试用/MDd，发布用/MD；切勿混用/MT和动态链接的第三方库 - 若使用 vcpkg 安装的库，必须确保其构建时使用的运行时库与项目一致（vcpkg 默认按
/MD构建）
包含目录和库目录路径不能依赖相对路径硬编码
在「配置属性 → C/C++ → 常规 → 附加包含目录」或「链接器 → 常规 → 附加库目录」中直接填 C:\boost\boost_1_83_0 类似路径，会导致项目无法被他人拉取即用，CI 构建也会失败。
真实痛点：同事克隆代码后点击生成，立刻报 fatal error C1083: Cannot open include file，却找不到哪一行配置错了。
- 优先使用宏变量，例如
$(SolutionDir)externals\boost\include或$(VCPKG_ROOT)\installed\x64-windows\include - 若用 vcpkg，推荐通过「项目右键 → vcpkg → 移植包」图形化操作，自动注入路径和预处理器定义，避免手输出错
- 绝对不要在路径中使用中文或空格；若路径含空格（如
Program Files），必须用引号包裹——但更稳妥的做法是重装到短路径如D:\vcpkg
调试控制台默认关闭，输出看不到就以为程序没跑
新建「空项目」或「Windows 桌面应用」时，控制台窗口默认不启用，std::cout 输出会静默丢失，新手常误判为 main 没执行、断点没命中或程序卡死。
这不是 bug，而是子系统类型（SubSystem）设置导致的：控制台程序用 Console，GUI 程序用 Windows。
- 在「配置属性 → 链接器 → 系统 → 子系统」中，确认值为
Console (/SUBSYSTEM:CONSOLE) - 若项目类型是「Windows 桌面应用」但又需要打印日志，可保留
Windows子系统，改用OutputDebugStringA+ Visual Studio 的「输出」窗口查看 - 调试时可在「项目属性 → 配置属性 → 调试 → 命令参数」中添加
-console等开关，并在代码中解析，兼顾 GUI 与调试输出
