前端开发npm run dev好好的，build就报错?90%的人都栽在这5个坑

npm run dev一切正常，build就报undefined？

2025年前端打包还在出这种错，九成开发者自己挖的坑。

环境变量配置问题、脚本缺失，老生常谈但年年犯。

开发环境加载.env.development，生产默认.env.production。

API_URL突然undefined？

变量名拼错或文件忘加，本地跑得欢，线上直接崩。

cross-env插件能救场，统一环境变量写法，NODE_ENV=production别漏。

变量前缀必须带VUE_APP_或REACT_APP_，框架才认账。

否则接口集体失联，打包成废品。

脚本命令找不到？

package.json里build定义了吗。

npm run build dev报错，多半scripts写错成build:dev。

直接检查脚本名拼写，别乱加空格。

npm ERR!

missing script: build这提示，赶紧翻package.json，补上脚本定义。

别以为dev能跑，build就自动顺。

node_modules位置乱窜导致报错。

项目目录下有node_modules，系统却跑去D盘找旧版本。

删光多余文件夹，重装Node.js才消停。

缓存清理不能省，npm cache clean先来一遍。

版本不兼容更头疼，Node.js 18以上可能卡住ES6语法，babel-loader转译失效。

TerserPlugin压缩时处女座附体，可选链操作符obj?

.a就罢工。

安全策略也捣乱。

Electron项目里webSecurity设false才能加载本地资源。

webpack.config.js配置异常，生产模式开启严格规则。

依赖冲突常有，更新到最新版试试。

说到底，开发测试别偷懒，CI/CD集成前跑完整build流程。

这些bug真不难避，花十分钟查配置省半天debug。

配置文件多检查，脚本命名别乱编，环境变量分开管。

工具不背锅，人得长记性。