Vite env配置实践

February 24, 2025 / xChenNing / 6阅读 / 0评论 / 分类: 前端项目控制解决方案学习

参考

Vite环境变量和模式

使用

内置常量

一些内置常量在所有情况下都可用:

  • import.meta.env.MODE: {string} 应用运行的模式
  • import.meta.env.BASE_URL: {string} 部署应用时的基本 URL。他由base 配置项决定。
  • import.meta.env.PROD: {boolean} 应用是否运行在生产环境(使用 NODE_ENV='production' 运行开发服务器或构建应用时使用 NODE_ENV='production' )。
  • import.meta.env.DEV: {boolean} 应用是否运行在开发环境 (永远与 import.meta.env.PROD相反)。
  • import.meta.env.SSR: {boolean} 应用是否运行在 server 上。

环境变量

Vite 自动将环境变量暴露在 import.meta.env 对象下,作为字符串。

但是只有 VITE_SOME_KEY 会被暴露为 import.meta.env.VITE_SOME_KEY 提供给客户端源码

.env 文件

Vite 使用 dotenv 从你的 环境目录 中的下列文件加载额外的环境变量:

.env                # 所有情况下都会加载
.env.local          # 所有情况下都会加载,但会被 git 忽略
.env.[mode]         # 只在指定模式下加载
.env.[mode].local   # 只在指定模式下加载,但会被 git 忽略
Command NODE_ENV Mode
vite build "production" "production"
vite build --mode development "production" "development"
NODE_ENV=development vite build "development" "production"
NODE_ENV=development vite build --mode development "development" "development"

dotenv

任意地方使用

比如vite.config.ts,用来从.env.*.local导入类似API_URL这样的敏感数据,而.env.*.local不会被添加到git(当然你得确认一下)

// Load env variables  
dotenv.config();

添加其他文件

// Load env variables  
dotenv.config({  
  path: [  
    ".env.development",  
    ".env.development.local",  
    ".env.production",  
    ".env.production.local",  
    ".env"  
  ]  
});

详细查看dotenv文档

#Vite(4)

文章作者:xChenNing

文章链接:https://blog.glcn.top/archives/vite-envpei-zhi-shi-jian

版权声明:本博客所有文章除特别声明外,均采用CC BY-NC-SA 4.0 许可协议,转载请注明出处!


评论