在 MacOS 上使用 Visual Studio Code (VSCode) 编译和运行 FluidX3D 项目，需要进行一系列配置。FluidX3D 是一个基于 C++ 的流体动力学模拟库，通常依赖于一些外部库（如 OpenGL、GLFW、FreeImage 等），因此需要确保所有依赖项都已正确安装，并且 VSCode 配置了合适的编译器和调试工具。

步骤一：安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤二：安装依赖

安装 CMake 和其他依赖：
brew install cmake
brew install glfw3
brew install freeimage
brew install glew

✅ 二、获取 FluidX3D 源码
你可以从 GitHub 克隆 FluidX3D 项目：
git clone https://github.com/ProjectPhysX/FluidX3D.git

配置 VSCode

1. 安装 C/C++ 扩展：在 VSCode 中搜索并安装 "C/C++" 和 "CMake Tools" 扩展。
2. 打开项目文件夹：File -> Open Folder，选择 FluidX3D 文件夹。
3. 配置 tasks.json：在 .vscode 文件夹下创建 tasks.json：
{
"version": "2.0.0",
"tasks": [
{
"label": "build",
"type": "shell",
"command": "cmake",
"args": ["-B", "build", "-DCMAKE_BUILD_TYPE=Release"],
"group": "build"
},
{
"label": "run",
"type": "shell",
"command": "./build/FluidX3D"
}
]
}

编译运行

按 Ctrl+Shift+P，输入 "Tasks: Run Task"，选择 build，然后 run。或者使用 CMake Tools 扩展自动配置。

另一个教程片段

首先确保安装了 Xcode Command Line Tools：xcode-select --install。然后 brew install pkg-config eigen gtest。然后 mkdir build && cd build，cmake .. -DCMAKE_BUILD_TYPE=Release，make -j4。

在 VSCode 中，按 F5 调试，需要 launch.json 配置 program 为 build/FluidX3D。

常见问题解决

如果链接错误，检查 brew link --force glfw 等。OpenGL 问题用 brew install freeglut。

Q: 编译时报找不到 GLFW？
A: brew reinstall glfw3，然后 export PKG_CONFIG_PATH=/opt/homebrew/lib/pkgconfig。

Q: VSCode 不识别头文件？
A: C/C++ 扩展配置 includePath 在 c_cpp_properties.json 中添加 /opt/homebrew/include。

Q: 运行时崩溃？
A: 检查 shaders 文件夹是否存在，确保权限正常。

Q: Mac M1/M2 芯片问题？
A: 用 brew install --universal glfw3 等，确保 arm64 架构。

Q: 如何调试？
A: 在 VSCode 创建 launch.json，设置 "program": "${workspaceFolder}/build/FluidX3D"。