Visual Studio C++项目初始化需严格对齐环境、模板、平台工具集和运行时库四要素：必须安装“使用C++的桌面开发”工作负载，创建时核对平台工具集（如v143）、字符集（推荐多字节防中文乱码）和运行时库（调试用/MDd，发布用/MD），优先选用“CMake项目”模板以确保CMakeLists.txt自动重载。
Visual Studio 项目初始化不是点几下“下一步”就完事的事——漏掉任何一个关键配置，后续大概率会遇到 LNK2001、unresolved external symbol、中文路径乱码、或调试时断点不命中等问题。核心在于：**环境、模板、平台工具集、运行时库这四者必须对齐**。
选对工作负载再建项目
安装 VS 时没勾选对应工作负载，新建项目时即使看到 C++ 模板，也可能编译失败。这不是界面问题，是底层工具链缺失。
- 纯 C++ 桌面开发：必须安装“使用 C++ 的桌面开发”工作负载（含 MSVC 编译器、Windows SDK、CMake 工具集）
- Qt 项目：额外确认已装
MSVC 2022 64-bit组件（Qt 6.5.3 官方只支持 v143 工具集） - 如果已安装但新建项目报
cl is not recognized，说明环境变量没加载——需手动运行vcvars64.bat或从“x64 本机工具命令提示符”启动 VS
创建时必须核对的三个配置项
在“配置新项目”页填完名称和路径后，别急着点“创建”。这三个字段直接影响能否链接成功、是否支持 Unicode、甚至能不能读写中文路径下的文件：
Visual Studio Professional 18.8.1
下载
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
-
平台工具集：VS 2022 默认是v143；若项目依赖旧库（如某些第三方 SDK），可能得切到v142，但要同步确认 Windows SDK 版本兼容 -
字符集：选“使用多字节字符集”可避免中文路径、资源文件名、fopen调用时出现乱码或返回NULL -
运行时库：调试用/MDd（动态调试版），发布用/MD；混用/MT和动态链接的第三方库会导致LNK2005
空项目 vs 预设模板：什么情况下该选“空项目”
很多教程直接让你选“控制台应用”，但真实开发中，尤其是集成 Qt、Boost 或嵌入式交叉编译时，“空项目”反而更干净、更可控。
- 选“空项目”后，需手动添加
main.cpp并设置属性：项类型 → C/C++ 文件，否则会被当成普通文本忽略编译 - 预设模板（如“Windows 桌面应用”）会自动生成
WinMain入口、资源脚本（.rc）、预编译头（stdafx.h），若你不需要 GUI 或想禁用 PCH，得进属性页关掉预编译头，否则编译报fatal error C1010 - 用 CMake 构建的项目，建议直接选“CMake 项目”模板，而非传统 VCXPROJ —— 否则 CMakeLists.txt 修改后不会自动重载，还得手动右键“重新生成缓存”
最容易被跳过的一步：创建完项目后，立刻打开“解决方案资源管理器”，右键项目 → “属性”，翻到“常规”页，确认 配置类型 是 应用程序(.exe) 还是 动态库(.dll)。这个选项一旦错，链接器会默默输出一个无法执行的文件，而错误列表里可能一条报错都没有。
