前端——不同环境下配置env

背景

问:

前端项目,如何配置使用env const isProd = process.env.NODE_ENV === 'production'

回复:

在前端项目里,把 process.env.NODE_ENV 注入到代码里只有 两步

  1. 在「构建工具」里把 NODE_ENV 写进环境变量

  2. 在「业务代码」里直接读 process.env.NODE_ENV(或你自己定义的其它变量)

下面给出主流脚手架/构建工具的「最小可运行」配置示例,按你正在用的那一节抄即可。

(所有示例都默认你已经装了对应 CLI,且项目根目录有 .env* 文件)

一、Create-React-App(react-scripts)

CRA 已经内置了 DefinePlugin,只要:

1.根目录新建

.env # 所有环境通用

.env.development # 开发环境

.env.production # 生产环境

2.文件里写(必须REACT_APP_ 开头)

REACT_APP_API_URL=https://api.example.com

3.代码里直接读

const isProd = process.env.NODE_ENV === 'production'

const apiRoot = process.env.REACT_APP_API_URL

4.启动

npm start // 会自动把 NODE_ENV 设为 development

npm run build // 会自动把 NODE_ENV 设为 production

二、Vite Vite 用 import.meta.env,但同样支持 .env 文件:

1.根目录新建

.env

.env.development

.env.production

2.变量名以 VITE_ 开头

VITE_API_URL=https://api.example.com

3.代码里读

const isProd = import.meta.env.PROD // vite 内置

const apiRoot = import.meta.env.VITE_API_URL

4.启动

npm run dev // 默认 development

npm run build // 默认 production

三、Webpack 手写配置 如果你是自己搭的 webpack,需要手动注入 DefinePlugin:

1.安装依赖

npm i -D dotenv-webpack // 或者 dotenv

2.webpack.config.js

const Dotenv = require('dotenv-webpack')

module.exports = (env, argv) => {
const isProd = argv.mode === 'production'

return {
mode: isProd ? 'production' : 'development',
plugins: [
new Dotenv({ // 把 .env 文件打进去
path: `./.env.${isProd ? 'production' : 'development'}```
}),
// 如果只想注入 NODE_ENV,可以简写:
// new webpack.DefinePlugin({
// 'process.env.NODE_ENV': JSON.stringify(argv.mode)
// })
]
}
}``

3.代码里照旧

const isProd = process.env.NODE_ENV === 'production'

四、Nuxt / Next

  • Next.js:内置 NEXT_PUBLIC_ 前缀,与 CRA 同理。

  • Nuxt2:使用 publicRuntimeConfig;Nuxt3 使用 runtimeConfig


五、常见坑速查

1.变量必须以约定前缀开头(REACT_APP_ / VITE_ / NEXT_PUBLIC_ ...),否则会被过滤。

2.不要给变量加引号:

正确

REACT_APP_FOO=bar

错误

REACT_APP_FOO="bar"

3.改完 .env 必须重启 dev server,热更新不会重新加载。

4.浏览器里 process 并不存在,构建阶段会被静态替换,所以

if (process.env.NODE_ENV === 'development') {

console.log('only in dev')

}

在 production 构建后整个 if 块会被 uglify 删掉,体积为零。


一句话总结

「把变量写到 .env.* 里 → 按构建工具要求加前缀 → 代码里直接读」即可;

只有裸 webpack 需要手动装插件/DefinePlugin。

相关推荐
掘金者阿豪1 分钟前
Seedance 2.0/2.5 虚拟素材能跨 Key 共用吗?一次讲清 Asset ID、账号隔离与 SaaS 素材架构
前端·后端
Jacky19994 分钟前
Electron + Vue 3 桌面打字游戏实战:从 VSCode 扩展到独立应用的架构改造
javascript
用户500937683903912 分钟前
热敏小票 Web 打印:我在 58/80mm 上折腾的两周
前端·vue.js
XGM18 分钟前
一个前端新手的"顿悟"时刻:DOM树、渲染原理和JS动态渲染
前端
东方小月31 分钟前
一篇文章带你深入拆解Skill的本质与工程实现,让你不再滥用Skill
前端·人工智能·后端
空想兔1 小时前
AgentPulse:实时监控所有的 OpenCode Agent 跑到哪一步了
react.js·ai编程
xy34531 小时前
Axure9.0 中继器遮罩的核心应用场景(精准适配列表交互)
前端·ui·html·原型·产品设计·axure9.0
天道kabuto1 小时前
记一次 UnoCSS 样式离奇失效的踩坑复盘
前端
前端小张同学1 小时前
AI全栈开发最佳实践💐
前端·后端·架构
前端 贾公子1 小时前
第09章:上下文与记忆 (6)
开发语言·前端·python