一文彻底搞懂Vite配置文件vite.config.js

 更新时间:2025年10月20日 10:04:31   作者:编程随想_Code  
这篇文章主要介绍了Vite配置文件vite.config.js的相关资料,这个vite.config.js文件是Vite项目的核心配置文件,它使用导出一个配置对象来定制Vite的行为,需要的朋友可以参考下

一、vite.config.js 是什么?

在使用 Vite 进行前端开发时,我们通常会在项目根目录下看到一个 vite.config.js 文件(也可以是 vite.config.ts)。

这个文件的作用类似于 webpack 的 webpack.config.js,用于对 Vite 的行为进行个性化配置,比如:

  • 修改开发服务器端口

  • 设置路径别名

  • 配置代理

  • 引入插件

  • 打包优化

Vite 默认情况下已经足够开箱即用,但在真实的项目开发中,我们通常需要通过配置文件来适配不同的业务需求。

二、vite.config.js 的基本结构

vite.config.js 本质上就是一个 配置对象,它通过 defineConfig 方法导出,写法如下:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [vue()],
  server: {
    port: 3000,
    open: true
  },
  resolve: {
    alias: {
      '@': '/src'
    }
  }
})

解释:

  • plugins:用于注册插件,比如 @vitejs/plugin-vue@vitejs/plugin-react 等。

  • server:配置开发服务器,比如端口号、代理等。

  • resolve.alias:配置路径别名,方便模块引入。

三、常见配置项详解

1. 基础配置

export default defineConfig({
  base: './', // 部署应用的基础路径,默认是 '/'
  root: './', // 项目根目录,默认就是当前目录
})
  • base:影响打包后的资源路径。如果你要把项目部署到子目录,需要设置为 /子目录/

  • root:指定项目根目录,默认是当前执行命令的目录。

2. 开发服务器 server

server: {
  host: '0.0.0.0', // 允许局域网访问
  port: 5173,      // 默认端口
  open: true,      // 是否自动打开浏览器
  proxy: {         // 配置反向代理
    '/api': {
      target: 'http://localhost:8080',
      changeOrigin: true,
      rewrite: (path) => path.replace(/^\/api/, '')
    }
  }
}
  • host:设置为 '0.0.0.0' 可以让其他设备访问本地服务。

  • proxy:解决跨域问题,常用于本地开发时转发请求到后端。

3. 路径别名 resolve

resolve: {
  alias: {
    '@': '/src',
    'components': '/src/components'
  }
}

这样我们在引入文件时可以简化路径:

import Header from '@/components/Header.vue'

4. 插件 plugins

Vite 的强大之处在于它的插件系统。
比如 Vue 项目通常需要:

import vue from '@vitejs/plugin-vue'
plugins: [vue()]

React 项目则需要:

import react from '@vitejs/plugin-react'
plugins: [react()]

5. 构建配置 build

build: {
  outDir: 'dist',     // 打包目录
  sourcemap: false,   // 是否生成 source map
  minify: 'esbuild',  // 压缩方式(esbuild 或 terser)
  rollupOptions: {
    output: {
      manualChunks: {
        vue: ['vue'], // 单独打包 vue 相关依赖
      }
    }
  }
}
  • outDir:打包后的文件输出目录。

  • rollupOptions:可以自定义 Rollup 打包行为,比如分包策略。

6. 环境变量与模式

Vite 默认支持 .env 文件,我们可以在配置文件中根据环境区分逻辑:

export default defineConfig(({ mode }) => {
  console.log('当前模式:', mode) // development / production
  return {
    base: mode === 'production' ? '/prod/' : '/'
  }
})

四、完整示例

下面给一个常用的 vite.config.js 配置示例:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig(({ mode }) => {
  return {
    base: mode === 'production' ? '/my-app/' : '/',
    plugins: [vue()],
    server: {
      host: '0.0.0.0',
      port: 3000,
      open: true,
      proxy: {
        '/api': {
          target: 'http://localhost:8080',
          changeOrigin: true,
          rewrite: path => path.replace(/^\/api/, '')
        }
      }
    },
    resolve: {
      alias: {
        '@': '/src'
      }
    },
    build: {
      outDir: 'dist',
      sourcemap: false,
      rollupOptions: {
        output: {
          manualChunks: {
            vue: ['vue']
          }
        }
      }
    }
  }
})

五、总结

  • vite.config.js 是 Vite 的核心配置文件,几乎所有定制化需求都在这里实现。

  • 常用的配置包括:server(开发服务器)、resolve.alias(路径别名)、plugins(插件)、build(构建优化)。

  • 可以根据不同环境(开发/生产)动态返回不同配置。

如果你之前是用 webpack 的,可能会觉得 Vite 的配置简洁得多,这也是 Vite 能够快速流行的原因之一。

到此这篇关于Vite配置文件vite.config.js的文章就介绍到这了,更多相关Vite配置文件vite.config.js内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Vue 收集表单数据方法详情

    Vue 收集表单数据方法详情

    这篇文章主要介绍了Vue 收集表单数据方法详情,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-05-05
  • TinyMCE富文本编辑器在Vue中的使用方式

    TinyMCE富文本编辑器在Vue中的使用方式

    这篇文章主要介绍了TinyMCE富文本编辑器在Vue中的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-04-04
  • vue3子组件数据无法更新问题

    vue3子组件数据无法更新问题

    这篇文章主要介绍了vue3子组件数据无法更新问题及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-10-10
  • 在vue中使用eacharts创建graph关系图方式

    在vue中使用eacharts创建graph关系图方式

    这篇文章主要介绍了在vue中使用eacharts创建graph关系图方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-09-09
  • 详解vue2如何实现点击预览本地文件

    详解vue2如何实现点击预览本地文件

    这篇文章主要为大家详细介绍了vue2如何实现点击预览本地的word、excle、pdf文件,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-04-04
  • 详解vue父子模版嵌套案例

    详解vue父子模版嵌套案例

    本篇文章主要介绍了详解vue父子模版嵌套案例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-03-03
  • 如何在 Vue 表单中处理图片

    如何在 Vue 表单中处理图片

    这篇文章主要介绍了如何在 Vue 表单中处理图片,帮助大家更好的理解和使用vue框架,感兴趣的朋友可以了解下
    2021-01-01
  • 解决vue-router中的query动态传参问题

    解决vue-router中的query动态传参问题

    下面小编就为大家分享一篇解决vue-router中的query动态传参问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • 浅谈Vue知识系列-axios

    浅谈Vue知识系列-axios

    这篇文章主要介绍了浅谈Vue知识系列-axios,本文章内容详细,具有很好的参考价值,希望对大家有所帮助,需要的朋友可以参考下<BR>
    2023-01-01
  • Vue2中配置Cesium全过程

    Vue2中配置Cesium全过程

    这篇文章主要介绍了Vue2中配置Cesium全过程,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05

最新评论