Mac M1环境下Node依赖安装报错：std命名空间中不存在'remove_cv_t'模板

我之前在M1 Mac上搭建Rails项目时也碰到过几乎一模一样的node-sass编译错误，结合你的环境（Node 16.2.0、MacOS 20.3.0），这本质是arm64架构与旧版node-sass/node-gyp的兼容性问题，可以按照以下步骤逐一排查解决：

1. 先清理残留依赖与缓存 #

先把已安装的依赖和缓存清干净，避免旧文件干扰：

rm -rf node_modules
yarn cache clean

2. 修复Command Line Tools的SDK配置 #

错误日志里提到了MacOSX.sdk的头文件问题，先确保你的Command Line Tools是最新的：

xcode-select --install
# 如果已经安装过，重置一下路径确保正确
sudo xcode-select --reset

然后确认SDK路径指向当前系统的最新版本：

xcrun --show-sdk-path
# 正常输出应该是类似 /Library/Developer/CommandLineTools/SDKs/MacOSX12.sdk（根据你的系统版本）

如果SDK路径不对，手动设置环境变量指定正确的SDK：

export SDKROOT=$(xcrun --show-sdk-path)

3. 升级node-sass到适配Node 16的版本 #

Node 16对应的node-sass最低版本是6.0.0，先检查你的package.json里的node-sass版本，如果低于这个版本，先升级：

yarn add node-sass@^6.0.0 --dev

如果升级后还是报错，可以尝试用Rosetta 2兼容模式运行终端（部分旧依赖还没适配arm64）：

• 找到「终端」应用，右键选择「显示简介」
• 勾选「使用Rosetta打开」，重启终端后再执行yarn install

4. 修复node-gyp的依赖问题 #

node-gyp在M1上需要额外的编译工具，先安装必要依赖：

brew install python3 make gcc

然后配置node-gyp使用Python 3（它默认可能找Python 2，而M1上默认没有Python 2）：

export PYTHON=$(which python3)

如果yarn install时卡在node-sass的重建步骤，手动进入node-sass目录执行重建：

cd node_modules/node-sass
node-gyp rebuild --verbose --arch=arm64

5. 终极方案：替换为dart-sass（推荐） #

如果以上方法都没解决，建议直接放弃node-sass，改用官方推荐的dart-sass——它对M1的兼容性要好得多，而且是未来的主流：

yarn remove node-sass
yarn add sass --dev

Rails 6已经原生支持dart-sass，不需要额外配置，替换后就能正常运行。

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