Emscripten编译C++生成WASM时找不到gsl/gsl头文件如何解决

emcc 编译时提示找不到 gsl/gsl 文件，核心原因是未将 ms-gsl（微软实现的 C++ 规范支持库，注意和 GNU 科学计算库 GSL 区分，代码中使用的 Expects 是 ms-gsl 的专属特性）的头文件目录加入编译器搜索路径。ms-gsl 是纯头文件库，无需提前编译二进制产物，只要路径配置正确即可直接引入使用。

• 第一步：获取 ms-gsl 源码

  • 本地部署：直接将 ms-gsl 仓库下的 include 目录放到项目第三方依赖路径下，例如项目内新建 third_party/ms-gsl 目录，保证目录结构为 third_party/ms-gsl/include/gsl/gsl，和代码中 #include <gsl/gsl> 的引用结构匹配。
  • 包管理部署：如果使用 vcpkg，执行 ./vcpkg install ms-gsl:wasm32-emscripten 安装适配 Emscripten 的版本即可，前提是提前配置好 vcpkg 与 Emscripten 的环境关联。

• 第二步：编译时指定头文件搜索路径
  如果是直接调用 emcc 命令编译，通过 -I 参数追加 ms-gsl 的头文件上层目录即可，示例编译命令：

  emcc --bind -o pwm.js PwmTest.cpp -I ./third_party/ms-gsl/include
  

  注意：-I 后面的路径必须是包含 gsl 文件夹的目录，不能直接指向 gsl 文件夹本身，否则编译器无法匹配 #include <gsl/gsl> 的路径规则。

  如果是用 CMake 构建，直接在 CMakeLists.txt 中添加如下配置即可自动处理路径，无需手动写 -I 参数：

  # 替换为你本地ms-gsl的实际存放路径
  add_subdirectory(third_party/ms-gsl)
  # 替换为你自己的项目编译目标名
  target_link_libraries(pwm_wasm PRIVATE Microsoft.GSL::GSL)
  

  配置完成后用 emcmake cmake 正常走构建流程即可。

• 不要装错库：不要通过系统包管理器安装 GNU 科学计算库（例如 Ubuntu 下的 libgsl-dev），该库是面向科学计算的 C 库，不存在 Expects 宏，也没有 gsl/gsl 这个 C++ 头文件，安装后依然会报错。
• 路径校验：如果加了路径参数依然提示找不到头文件，直接进入 -I 指定的目录，确认目录下是否存在 gsl/gsl 文件，绝大多数路径报错都是因为指定的目录层级不对。

配置完成后重新执行编译，即可正常使用 ms-gsl 的 Expects 等所有特性，生成可用的 WASM 产物。

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