空项目创建后必须手动添加源文件，否则编译报LNK1181错误；需右键项目→“添加”→“新建项”→建main.cpp并实现int main()；配置第三方库须同步设置包含目录、附加依赖项及运行时库，且平台（x64/x86）须全程一致。
空项目创建后必须手动添加源文件
Visual Studio 的“空项目”模板不自动生成 main.cpp 或任何源文件，直接编译会报错 LNK1181: cannot open input file 'main.obj'。这不是环境问题，是项目结构缺失导致的。
- 右键项目名 → “添加” → “新建项” → 选择“C++ 文件(.cpp)” → 命名为
main.cpp - 至少写一个合法入口：含
int main()，哪怕只写return 0; - 若用 C 风格，可建
main.c，但需确认项目属性中 C/C++ → “高级” → “编译为”设为/TC（否则默认按 C++ 解析）
WinFsp 开发必须配对设置平台与库路径
配置 WinFsp 时最常踩的坑是 $(PlatformTarget) 展开错位——比如项目设为 x64，却装了 x86 版 WinFsp，或反之。链接器会找不到 winfsp-x64.lib，报错 LNK1104: cannot open file 'winfsp-x64.lib'。
Visual Studio Professional 18.8.1
下载
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
- C/C++ → “附加包含目录”填：
$(MSBuildProgramFiles32)\WinFsp\inc - 链接器 → “附加库目录”填：
$(MSBuildProgramFiles32)\WinFsp\lib - 链接器 → “附加依赖项”填：
winfsp-$(PlatformTarget).lib（不是winfsp.lib） - 务必检查顶部工具栏：平台下拉菜单是否与已安装 WinFsp 架构一致（x64 / x86），且“配置”是 Debug 或 Release（二者路径一致，但运行时 DLL 加载行为不同）
第三方库通用配置三步不能少
无论 Boost、OpenSSL 还是自建静态库，漏掉任意一步都会导致编译失败或运行时崩溃。关键不是“加路径”，而是让编译器、链接器、加载器各司其职。
-
头文件阶段：C/C++ → “附加包含目录”加头文件根路径，例如
C:\boost\boost_1_83_0（不是子目录） -
链接阶段：链接器 → “附加依赖项”写具体 .lib 名，如
boost_system-vc143-mt-x64-1_83.lib（注意匹配工具集 v143 和架构） -
运行时阶段：若用动态库，需把对应 .dll 放到可执行目录，或确保其在
PATH中；静态库则无需此步
字符集和运行时库不匹配会静默出错
中文路径读取失败、fopen 返回 NULL、甚至 std::string 构造异常，常因“字符集”和“运行时库”两处配置冲突。它们不报编译错误，但会在运行时崩得莫名其妙。
- 项目属性 → “常规” → “字符集”：选“使用多字节字符集”（避免 Unicode 下宽字符路径处理异常）
- C/C++ → “代码生成” → “运行时库”：Debug 下用
/MDd（多线程调试 DLL），Release 下用/MD；切勿混用/MT（静态链接）与第三方动态库 - 特别注意：WinFsp 自带的
winfsp-$(PlatformTarget).dll是动态链接的，所以你的项目必须用/MD或/MDd，否则加载失败
$(PlatformTarget) 在属性页里的实际展开值，三者必须咬死。 
