Node.js v22.14.0执行npm run dev报错：--r=不允许在NODE_OPTIONS中

问题场景 #

新笔记本安装Node.js v22.14.0，从GitHub克隆Next.js项目后执行npm install成功安装依赖，但运行npm run dev启动本地开发服务器时，终端报错：

C:\Users\User\Documents\Code\project>npm run dev

> project@0.1.0 dev
> next dev --turbopack

C:\Program Files\nodejs\node.exe: --r= is not allowed in NODE_OPTIONS

项目的package.json内容如下：

{
  "name": "project",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "next lint"
  },
  "dependencies": {
    "@tailwindcss/postcss": "^4.0.0",
    "@vercel/analytics": "^1.4.1",
    "class-variance-authority": "^0.7.1",
    "clsx": "^2.1.1",
    "lucide-react": "^0.475.0",
    "next": "15.1.6",
    "postcss": "^8.5.1",
    "react": "^19.0.0",
    "react-confetti": "^6.2.2",
    "react-dom": "^19.0.0",
    "tailwind-merge": "^3.0.1",
    "tailwindcss": "^4.0.0",
    "tailwindcss-animate": "^1.0.7"
  }
}

解决方法 #

1. 清理系统环境变量中的NODE_OPTIONS #

• 按Win+R输入sysdm.cpl打开系统属性窗口，切换到「高级」标签页，点击「环境变量」
• 在「用户变量」或「系统变量」列表中查找NODE_OPTIONS
• 如果该变量的值包含--r=开头的内容，直接删除这个变量，或者清空其值后保存

2. 清理npm配置中的node-options #

打开终端执行以下命令：

# 查看当前npm的node-options配置
npm config get node-options
# 如果返回包含--r=的内容，执行删除命令
npm config delete node-options

3. 临时在启动脚本中清空NODE_OPTIONS #

如果上述方法没生效，可以修改package.json的dev脚本，启动时临时清空环境变量：

"scripts": {
  "dev": "set NODE_OPTIONS= && next dev --turbopack",
  "build": "next build",
  "start": "next start",
  "lint": "next lint"
}

4. 兼容性检查 #

Next.js 15.1.6理论上支持Node.js v22，但如果问题依旧，可以尝试：

• 降级Node.js到v20 LTS版本
• 升级Next.js到最新稳定版

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