保姆级教程：用Emscripten SDK（emsdk）在Windows上编译OCCT-WASM，搞定Web版OpenCASCADE

从零构建Web版CAD引擎：Windows下OCCT-WASM全流程编译指南

在工业设计、建筑建模和三维可视化领域，OpenCASCADE（简称OCCT）作为开源的几何建模内核，一直是专业开发者的首选工具之一。而随着Web技术的迅猛发展，通过WebAssembly将OCCT移植到浏览器环境运行，成为打破平台限制、实现云端CAD的新范式。本文将手把手带您完成Windows系统下OCCT-WASM开发环境的完整搭建，涵盖从工具链配置到最终样例编译的全过程。

1. 环境准备：构建WASM编译工具链

1.1 基础工具安装

任何WASM项目的编译都离不开核心三件套：Git版本控制、MinGW编译器集合和CMake构建系统。建议按以下顺序安装：

• Git for Windows ：从 官网 下载最新安装包，安装时勾选"Add to PATH"选项
• MinGW-w64 ：推荐使用 MSYS2 提供的pacman包管理器安装：

  pacman -S mingw-w64-x86_64-toolchain
  

• CMake ：从 官方下载页 获取Windows x64安装包，安装时选择"Add CMake to system PATH"

安装完成后，在PowerShell中验证各工具版本：

git --version
gcc --version
cmake --version

1.2 Emscripten SDK配置

Emscripten是将C/C++代码编译为WASM的核心工具链，其安装过程需要特别注意版本兼容性：

1. 克隆emsdk仓库：

   git clone https://github.com/emscripten-core/emsdk.git
   cd emsdk
   

2. 安装指定版本（推荐2.0.29稳定版）：

   ./emsdk install 2.0.29
   ./emsdk activate 2.0.29
   

3. 配置环境变量：

   emsdk_env.bat
   

验证安装成功：

emcc --check

注意：每次打开新终端都需要先执行 emsdk_env.bat ，或将其添加到系统环境变量

2. 依赖库编译：FreeType字体引擎

2.1 源码获取与准备

FreeType是OCCT渲染文字必需的依赖项，需要单独编译为WASM版本：