vite基础使用及相关配置

news2025/7/13 11:22:42

在这里插入图片描述

前言

这篇文章主要是记录前段时间公司里以vite构建的一个小项目（前端界面不多，主要功能及相关配置是在后端），挺简单的几个小页面。
说到vite，之前虽然都有学习了解及demo尝试，但因为业务等其他各方面因素也一直没有一个正式的，借这次机会特别记录下。

Vite介绍

不说废话，去官网看看

配置

环境变量

根目录下创建env文件夹（也可以不创建env文件夹，直接在根目录下创建对应的环境变量文件）
分别创建自己需要的环境文件及对应的配置

// 类似于这种方式进行配置
NODE_ENV="develop"
VITE_APP_BASEAPI="https://www.dev.com"

vite.config.ts文件中进行配置

// 用于加载 .env 文件的目录。可以是一个绝对路径，也可以是相对于项目根的路径。
envDir: 'env',

重启项目
可以在项目中通过 import.meta.env打印当前的环境等变量相关信息

console.log('import.meta.env::', import.meta.env)

参考官方文档及对应vite envDir 配置信息

配置host及port

在vite.config.ts文件下server中进行配置，请参照配置代理
在package.json中的scripts中进行配置

  "scripts": {
    "start": "vite --open --host=localhost --port=4000 --mode develop",
  },

配置代理

// 配置反向代理
server: {
	host: 'localhost',  // 启动后浏览器窗口输入地址就可以进行访问
	port: 4500, // 端口号
	open: true, //是否自动打开浏览器
	cors: true, //为开发服务器配置 CORS , 默认启用并允许任何源
	https: false, //是否支持http2 如果配置成true 会打开https://localhost:3001/xxx;
	strictPort: true, //是否是严格的端口号，如果true，端口号被占用的情况下，vite会退出
	hmr: true, // 开启热更新
	proxy: {
		'/api': {
			// 配置接口调用目标地址
			target: 'https://www.xxxx.com/xxxx',
			// 当进行代理时，Host 的源默认会保留（即Host是浏览器发过来的host），如果将changeOrigin设置为true，则host会变成target的值。
			changeOrigin: true,
			// 前缀 /api 是否被替换为特定目标，不过大多数后端给到的接口都是以/api打头，这个没有完全固定的答案，根据自己的业务需求进行调整
			rewrite: path => path.replace(/^\/api/, ''),
		}
	}
},

配置别名

resolve: {

	// 配置别名
	alias: {
		'@': resolve(__dirname, 'src'),
		"@c": resolve(__dirname, "src/components"),
	},
	
	// 导入时想要省略的扩展名列表
	extensions: ['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json'],
},

vite.config.js中引入path报错

在这里插入图片描述

解决方法：

npm install @types/node --save-dev

# 或者

yarn add @types/node

配置第三方插件

如果项目要使用第三方插件，需要在 external 里面进行配置：

配置Less

yarn add less

配置预览

//预览设置  npm run build　打包之后，会生成dist文件 然后运行npm run preview；vite会创建一个服务器来运行打包之后的文件
preview: {
	host: 'localhost',
	port: 4200,//端口号
	open: true,//是否自动打开浏览器
	cors: true, // 配置 CORS
	proxy: { // 配置自定义代理规则
		'/api': {
			target: 'http://jsonplaceholder.typicode.com',
			changeOrigin: true,
			rewrite: (path) => path.replace(/^\/api/, '')
		}
	},
},

配置打包

// 打包配置 npm run build
build: {
	// 最终构建的浏览器兼容目标，类型：string | string[]
	target: '',
	//指定输出路径
	outDir: "dist",
	//生成静态资源的存放路径
	assetsDir: "assets",
	//小于此阈值的导入或引用资源将内联为 base64 编码，以避免额外的 http 请求。设置为 0 可以完全禁用此项
	assetsInlineLimit: 4096,
	//启用/禁用 CSS 代码拆分，如果指定了 build.lib，build.cssCodeSplit 会默认为 false
	cssCodeSplit: true,
	/*
	构建后是否生成 source map 文件, boolean | 'inline' | 'hidden'
	默认：false
	true: 创建一个独立的 source map 文件
	inline: source map 将作为一个 data URI 附加在输出文件中
	hidden: 的工作原理与 'true' 相似，只是 bundle 文件中相应的注释将不被保留
	*/
	sourcemap: false,
	//自定义底层的 Rollup 打包配置
	rollupOptions: {
		// 可以配置多个，表示多入口
		input: {
			index: resolve(__dirname, "index.html")
		},
		output: {
			chunkFileNames: 'static/js/[name]-[hash].js',
			entryFileNames: "static/js/[name]-[hash].js",
			assetFileNames: "static/[ext]/name-[hash].[ext]"
		}
	},
	//默认情况下，若 outDir 在 root 目录下，则 Vite 会在构建时清空该目录。
	emptyOutDir: true,
	//chunk 大小警告的限制
	chunkSizeWarningLimit: 500
}