Visual Studio 2022中jsoncpp与C++/WinRT集成编译错误排查

我在 Visual Studio 2022 中尝试集成 jsoncpp 和 C++/WinRT 时遇到了多个问题：

• 包管理：已通过 NuGet 包管理器安装 jsoncpp 和 jsoncpp.windows
• jsoncpp 引入错误：使用 #include <json/json.h> 时，出现「无法打开头文件」「allocator.h 语法错误」等编译问题
• C++/WinRT 集成错误：通过 NuGet 引入 C++/WinRT 并包含相关头文件后，base.h 出现约 45 个语法错误，同时存在 IInspectable、IUnknown 符号歧义问题
• 已尝试方案：从 GitHub 下载 jsoncpp 手动添加到项目，检查依赖安装情况，但问题仍未解决

咨询问题：这些错误的原因是什么？是两者冲突还是项目配置问题？是否需要重装 Visual Studio 2022，或有其他解决方案？

一、错误核心原因 #

这类问题基本是项目配置冲突或依赖版本不兼容导致，和 Visual Studio 本身无关，不需要重装。具体诱因包括：

1. 头文件包含顺序错误：C++/WinRT 定义的 Windows 运行时类型会覆盖标准库同名类型（如allocator），若后包含 C++/WinRT 头文件，会引发语法冲突。
2. NuGet 包版本不匹配：jsoncpp、C++/WinRT 的版本与 VS2022 配套的 MSVC v143 工具集不兼容，或两个包之间存在隐性依赖冲突。
3. 项目属性配置错误：未正确加载 NuGet 包的包含目录，或启用了矛盾的编译选项（如/ZW运行时扩展与纯标准 C++ 模式冲突）。

二、分步解决方法 #

1. 修正头文件包含顺序 #

强制先包含 C++/WinRT 头文件，再引入 jsoncpp，示例代码：

#include <winrt/base.h>
#include <winrt/Windows.Foundation.h>
// 后包含 jsoncpp
#include <json/json.h>

此操作可避免 Windows 运行时类型覆盖标准库类型，解决allocator.h错误和符号歧义问题。

2. 清理并重装兼容的 NuGet 包 #

• 卸载当前的jsoncpp、jsoncpp.windows和 C++/WinRT 包
• 仅安装jsoncpp.windows（无需同时装通用版jsoncpp），选择适配 VS2022 的稳定版本
• C++/WinRT 选择匹配 MSVC v143 工具集的最新稳定版
• 安装完成后，右键项目→管理 NuGet 程序包，确认依赖项无冲突提示

3. 检查并修正项目属性配置 #

• 右键项目→属性→C/C++→常规：确认「附加包含目录」包含 NuGet 包的头文件路径（NuGet 通常自动添加，缺失则手动添加$(SolutionDir)packages\jsoncpp.windows.x.x.x\build\native\include类路径）
• 右键项目→属性→C/C++→语言：设置「C++ 语言标准」为C++17或更高（jsoncpp 和 C++/WinRT 均依赖现代 C++ 标准）
• 若非 UWP/Windows 应用 SDK 项目，关闭「Windows 运行时扩展」选项（/ZW），该选项与纯标准 C++ 模式冲突

4. 手动集成 jsoncpp（替代 NuGet） #

若 NuGet 包仍有问题，可手动编译集成：

• 从 jsoncpp 仓库下载稳定版，用 CMake 生成 VS2022 项目（指定 MSVC v143 工具集）
• 编译生成静态库jsoncpp.lib
• 在你的项目中添加静态库引用，手动配置 jsoncpp 的头文件目录
• 确保编译选项（C++标准、运行库类型）与主项目完全一致

三、常见误区规避 #

• 不要同时安装jsoncpp和jsoncpp.windows，二者功能重复，仅需安装适配 Windows 的jsoncpp.windows
• 必要时用命名空间隔离符号冲突，比如using namespace json;明确指定 jsoncpp 的命名空间

内容的提问来源于stack exchange，提问作者LeeNux