升级MacOS Sequoia 15.2后运行yarn遇模块及头文件错误求助

一、处理「Cannot find module './build/Release/GcProfiler'」模块缺失问题 #

• 清理依赖缓存并重装：
  1. 删除项目里的node_modules文件夹：rm -rf node_modules
  2. 删除yarn.lock锁定文件：rm yarn.lock
  3. 清空node-gyp全局缓存：rm -rf ~/.node-gyp
  4. 重新安装依赖：yarn install
• 若重装无效，手动触发模块编译：
  在项目根目录执行npx node-gyp rebuild，强制重新构建GcProfiler模块

二、解决「'atomic' file not found」编译错误 #

这个问题是Sequoia系统的clang编译器标准库路径变更导致的，按以下步骤修复：

• 先配置环境变量指定C++标准库路径，执行：

  export CFLAGS="-I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/c++/v1"
  export CXXFLAGS="-I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/c++/v1"
  

• 确保Command Line Tools是最新版：
  运行xcode-select --install完成更新，或者打开Xcode的「偏好设置 > 位置」，确认选中了最新的Command Line Tools
• 最后重新执行yarn命令：yarn

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