Sol2报错‘incomplete type "sol::state" is not allowed’求助

以下是几个你可能遗漏的配置项，按顺序排查：

1. 确保包含完整的Sol2头文件 #

sol::state的定义在Sol2的核心头文件里，你的代码必须包含：

#include <sol/sol.hpp>

如果只引入了Sol2的子头文件（比如单独引入<sol/state.hpp>），会导致类型定义不完整。

2. 添加Lua的包含路径 #

Sol2依赖Lua，除了Sol2的包含目录，还得把Lua的头文件目录加到项目里：

• 打开项目属性 → C/C++ → 常规 → 附加包含目录，添加vcpkg安装的Lua包含路径（通常是vcpkg/installed/[你的平台，比如x64-windows]/include）

3. 链接Lua的库文件 #

Sol2是纯头文件库，但必须链接Lua的二进制库才能正常工作：

• 项目属性 → 链接器 → 输入 → 附加依赖项，添加对应版本的Lua库（比如lua54.lib，具体看你安装的Lua版本）
• 同时在链接器 → 常规 → 附加库目录中，添加Lua库所在的路径（vcpkg/installed/[你的平台]/lib）

4. 确认vcpkg集成生效 #

如果是用vcpkg安装的库，确保已经完成VS集成：

• 打开VS的「工具」→「NuGet包管理器」→「包管理器控制台」，运行vcpkg integrate install，确认输出显示集成成功。

5. 匹配项目平台与vcpkg安装平台 #

比如你装的是x64版本的库，项目必须设置为x64平台（项目属性 → 配置属性 → 常规 → 平台），否则会出现路径或库不匹配的问题。

6. 清理并重新编译 #

有时候VS的缓存会导致奇怪的问题，先执行「生成」→「清理解决方案」，再重新生成项目。

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