Visual Studio发布React/.NET Core项目报JavaScript堆内存不足错误

首先明确本地运行正常、发布构建报错的核心差异：

• 本地VS启动的是React开发模式构建，采用增量编译机制，仅编译修改的文件，不会执行生产环境专属的全量tree shaking、代码混淆压缩、全量sourcemap生成、静态资源内联等高内存消耗操作，内存占用始终维持在较低水平。
• 发布时触发的npm run build是全量生产构建，单进程需要一次性加载所有项目依赖、组件、静态资源完成打包，内存峰值是开发模式的3~10倍，很容易触发NodeJS默认的堆内存上限。

你之前尝试的方案未生效，核心是两个常见的配置误区：一是内存参数传递对象错误，二是VS发布默认调用内置Node实例，未复用你系统配置的Node环境。按以下顺序排查修改即可解决：

1. 修正内存参数传递方式 #

--max-old-space-size是NodeJS进程的启动参数，不是react-scripts的运行参数，之前直接加在react-scripts后的写法不会生效，需修改package.json的build命令为：

"scripts": {
  // Windows环境写法
  "build": "node --max-old-space-size=8192 node_modules/react-scripts/scripts/build.js",
  // 如果是Linux/macOS环境用下面的写法
  // "build": "NODE_OPTIONS=--max-old-space-size=8192 react-scripts build"
}

如果不需要生产环境sourcemap，可以额外关闭sourcemap生成，进一步降低内存消耗：

"build": "set GENERATE_SOURCEMAP=false && node --max-old-space-size=8192 node_modules/react-scripts/scripts/build.js"

2. 强制VS发布使用系统安装的Node #

Visual Studio默认内置了独立的NodeJS实例，不会读取你系统的Node版本、环境变量配置，升级系统Node、修改系统环境变量对VS内置Node完全无效，需要修改项目.csproj文件，强制指定使用你系统安装的Node路径：

<PropertyGroup>
  <!-- 原有配置保持不变，新增下面这行，路径替换为你系统node.exe的实际路径 -->
  <NodeExecutable>C:\Program Files\nodejs\node.exe</NodeExecutable>
</PropertyGroup>

注意确认使用的Node是64位版本：32位Node最多只能使用4GB内存，无论设置多大的堆内存参数都不会生效。

3. 排查冗余资源/依赖 #

如果以上配置修改后仍报错，排查项目是否存在以下额外占用内存的情况：

• 未经过压缩的高清图片、测试数据JSON、设计源文件等非必要资源是否放在了src目录下，打包时会被全量加载
• 执行npm ls检查是否存在同一依赖安装多个版本的情况，重复依赖会大幅提升打包内存占用，可通过npm dedupe命令合并重复依赖

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