uniapp 多环境配置打包,比较优雅的解决方案,全网相对优解

uniapp 多环境配置打包,比较优雅的解决方案,全网相对优解

读取.env.[development|test|staging|production]配置文件进行打包,最终效果如下图可以看到多个环境, 并且我们可以自定义更多的环境配置

前言

由于uniapp的hbuilder开发工具,只提供了development和production的环境编译方式,一般来说,只能做到development和production两个环境的区分。在实际开发中,我们如果有多个环境开发需求和打包需求,尤其是配置多个环境的接口请求地址等配置。 针对这种情况,我在网上找了很多相关的资料,基本都是命令行的方案,使用uniapp的scripts方案也有,但是是把配置信息写到scripts上的,这解决方案也不够优雅,如果有多个配置就显得很拥肿了。

下面,我们一步一步来配置实现如何根据编译环境读取对应的.env文件加载到项目中。(下面只讲vite配置的方式,webpack的配置方式有空再补充)

配置实现

  1. 项目根目录,自行新增对应的配置文件

  2. 在package.json文件添加uni-app的scripts,需要配置几个环境就添加几个,关于这个配置的意思,可以去查看其他相关的文档,这里不展开讲述。 配置好后,点击运行和发行就能看到对应的环境选择项了 此时只是有对应的环境选择项,接下来的思路就是,判断对应的script执行环境,来加载不同的.env配置文件,读取到项目中

  3. 修改vite.config.js文件,重点看注释

javascript 复制代码
import { loadEnv } from 'vite';
import uni from '@dcloudio/vite-plugin-uni';
// import viteCompression from 'vite-plugin-compression';
// https://vitejs.dev/config/
export default (command, mode) => {//uniapp中,这个mode,不用命令行的添加--mode编译的话,是undefined的
	let env = undefined;
	if(!mode){//这里是为了确保mode有值,假如开发人员直接在开发工具选择编译到浏览器,也能兼容到
		if(process.env.NODE_ENV=='production'){
			mode = 'production'
		}else{
			mode = 'development'
		}
	}
	switch (process.env.UNI_SCRIPT){//这个就是第三步配置的uni-app的script,一一对应判断
		case 'dev-h5':
			mode = 'development';
			break;
		case 'test-h5':	
			mode = 'test'
			break;
		case 'stage-h5':
			mode = 'staging'
			break;
		case 'prod-h5':
			mode = 'production'
			break;
	}
	env = loadEnv(mode, __dirname,"APP")
	console.log(`编译${mode}环境`)
	console.log(env);//此时已经把env配置读取到了,并且这是个json格式,
	return {//别试图在这里定义mode,试过了,在uniapp中不起作用,目前方案只想到了用define来做
		envPrefix:'APP_',
		plugins: [
			uni()
		],
		server: {
			host: true,
			// open: true,
			port: env.APP_PORT,
			hmr: {
				overlay: true,
			},
		},
		define:{//根据vite的官方文档,可以把define定义的变量名,在项目编译时,识别项目文件中的这个变量名直接替换成env配置,我们把这个变量放到config.js文件中,对env配置进行集中管理
			__VITE_ENV__:JSON.stringify(env)
		}
	};
};
  1. 接下来在项目中由一个config.js文件来集中管理env相关的配置,再暴露出来给其他业务模块调用。 至此,uniapp的多环境配置已经完成!!! 如果需要命令行配置打包,可以参考其他的博客,直接配置命令行就可以,命令行写--mode参数即可。
相关推荐
Live0000019 小时前
在鸿蒙中使用 Repeat 渲染嵌套列表,修改内层列表的一个元素,页面不会更新
前端·javascript·react native
柳杉19 小时前
使用Ai从零开发智慧水利态势感知大屏(开源)
前端·javascript·数据可视化
兆子龙19 小时前
从高阶函数到 Hooks:React 如何减轻开发者的心智负担(含 Demo + ahooks 推荐)
前端
狗胜19 小时前
测试文章 - API抓取
前端
三小河19 小时前
VS Code 集成 claude-code 教程:告别海外限制,无缝对接国内大模型
前端·程序员
jerrywus19 小时前
前端老哥的救命稻草:用 Obsidian 搞定 Claude Code 的「金鱼记忆」
前端·agent·claude
球球pick小樱花19 小时前
游戏官网前端工具库:海内外案例解析
前端·javascript·css
用户605723748730819 小时前
AI 编码助手的规范驱动开发 - OpenSpec 初探
前端·后端·程序员
狗胜19 小时前
AI观察日记 2026-03-02|CLAUDE、TYPE、APPFUNCTIONS:掘金热门里的下一步信号
前端