开发环境运行refined-github扩展遇NODE_OPTIONS中--import不允许的错误求助

问题详情 #

• 系统环境：Windows 11
• Node.js版本：v16（已尝试切换至v18）
• 触发场景：在开发环境执行Refined GitHub扩展的build:webpack构建命令
• 错误输出：

node: --import is not allowed in NODE_OPTIONS
ERROR: "build:webpack" exited with 9.

• 已尝试无效操作：
  • 取消设置当前终端的NODE_OPTIONS环境变量
  • 切换Node.js版本至v18
  • 查阅Stack Overflow相关问题未找到有效方案

可行解决方案 #

1. 排查项目脚本的NODE_OPTIONS注入 #

打开项目根目录的package.json，定位到scripts字段下的build:webpack命令，检查是否存在直接设置NODE_OPTIONS='--import=...'的代码。如果有，移除该部分配置——--import参数在Node.js v16中不支持通过NODE_OPTIONS传递，且v18中也推荐通过其他方式配置ES模块导入（比如在webpack配置文件中使用对应插件）。

2. 清理依赖缓存并重装 #

Windows环境下依赖缓存可能导致版本不兼容，执行以下命令：

# npm 用户
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

# yarn 用户
yarn cache clean
rm -rf node_modules yarn.lock
yarn install

3. 检查系统全局NODE_OPTIONS设置 #

即使当前终端已取消NODE_OPTIONS，系统全局环境变量可能仍有残留：

1. 打开Windows设置 → 系统 → 关于 → 高级系统设置 → 环境变量
2. 在「系统变量」和「用户变量」列表中查找NODE_OPTIONS，若存在则删除该变量
3. 重启所有终端窗口后重新执行构建命令

4. 强制指定Node版本运行构建 #

如果版本切换工具（如nvm）未生效，尝试用npx临时指定Node版本执行：

npx -p node@18 npm run build:webpack

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