npm run build/export与next build/export差异及next build报错解决

• next build、next export是Next.js提供的原生二进制命令，直接调用时系统会从全局环境变量PATH配置的路径里查找对应可执行文件运行，不会主动读取项目本地的依赖。
• npm run build、npm run export是npm的脚本运行指令，执行时会先读取项目根目录package.json中scripts字段下配置的对应命令，同时自动将项目本地node_modules/.bin目录临时加入PATH最优先级，优先调用项目本地安装的依赖版本执行。

直接运行next build报错、但npm run build正常的核心原因是命令调用的Next.js版本不一致：
你直接在终端敲next build时，系统要么找不到本地安装的next命令（因为本地依赖路径没加进全局PATH），要么调用了你全局安装的Next.js包——这个全局版本和你项目package.json里依赖的Next.js版本大概率存在大版本差异，API、配置规则不兼容就会触发构建报错。
而npm run build执行时永远优先调用项目本地node_modules里安装的、和项目配置匹配的Next.js版本，版本适配自然可以正常构建生成产物。

你可以根据自己的使用习惯选以下任意一种方案：

• 官方推荐方案：统一通过npm脚本执行构建、导出命令，也就是一直用npm run build、npm run export，从根源避免全局和本地版本不一致的问题，也是所有Node.js项目的通用最佳实践。
• 临时直接调用方案：在命令前加npx前缀，执行npx next build、npx next export，npx会自动优先查找项目本地的依赖二进制执行，路径查找逻辑和npm run完全一致，不需要改全局配置。
• 当前终端生效方案：如果你用Mac/Linux系统，在当前终端执行export PATH=./node_modules/.bin:$PATH；如果用Windows CMD，执行set PATH=.\node_modules\.bin;%PATH%，将本地依赖的二进制路径临时加入当前终端的环境变量，之后再直接敲next相关命令就会调用本地版本。
• 全局适配方案（不推荐）：全局安装和你项目本地版本号完全一致的Next.js，执行npm i -g next@<你的项目依赖的next版本号>，版本匹配后直接执行next命令也不会报错，但后续项目升级Next.js版本时需要同步升级全局包，维护成本很高。

补充提示：如果你使用的是Next.js 13及以上版本，不需要单独执行next export生成静态产物，只要在next.config.js中配置output: 'export'，执行build命令时会自动同步生成静态导出文件，简化构建流程。

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