编程入门Vite_Vue3使用Vite构建项目_Vite创建Vue3项目

自Vue CLI转变至Vite,宛如原将整锅饭一同加热转而仅热你即刻要吃的那一碗,其启动速度加快程度实非一点半点。此一变化径直化解了Vue 2时期项目的一大痛点:项目规模越大,本地开发启动便越迟缓。

Vue CLI的瓶颈在哪里

Vue CLI依托Webpack,启动项目之际需从入口文件着手,将整个项目的全部模块逐一进行扫描、分析,而后打包成一个文件。此过程无论你当下正处于开发哪一个页面,所有路由相匹配的组件均会被编译。我于2023年维护过一个中型的Vue 2后台管理系统,其路由表存有120多个,本地启动耗时稳定在3分40秒,每天首次拉取代码后干等三分钟已然成为既定动作。

带来更加折磨之感的是热更新,去修改一行代码时,Webpack常常需要耗费十几秒的时间来重新进行打包,有时甚至会超过半分钟,这样的等待极其容易打断思路,当原本你打算去调整一个样式时,但打开浏览器之后却要等待很长时间,等回来时已然忘记了刚才打算要修改的内容。

Vite的核心改进点

  #使用npm create命令创建项目
  npm create vite@latest
  #使用yarn create命令创建项目
  yarn create vite

Vite借助现代浏览器原生对ES Module的支持特性,项目启动之际无需打包整个应用,浏览器发起请求,请求哪一个文件,Vite便实时编译该文件并返回,按需加载这四个字,在Vue 3项目里感受极为直观。

  yarn create vite

就拿我去年10月接手的电商管理端项目来说,它采用的是Vue 3 + Vite,首屏启动时间为8秒。对于同样规模的Vue 2项目,若使用Vue CLI,要等待2分10秒。这并非实验室数据,而是我自己在2025年12月的真实记录。Vite的热替换精确到了毫秒级,修改完代码保存后,在0.5秒内页面就发生了变化,并且不刷新页面、不丢失状态。

Vue3使用Vite构建项目_编程入门Vite_Vite创建Vue3项目

创建Vite项目的两种操作路径

Vue3使用Vite构建项目_Vite创建Vue3项目_编程入门Vite

动手创建契合需要灵活进行配置的场景。于D盘构建项目目录之后,去执行npm create vite@latest,命令行就会提示输入成项目名、挑选框架。在2026年2月的当下,Vite已然更新至5.x版本,选项当中增添了Solid、Qwik等新框架,Vue自然而然一直处于列表里面。

编程入门Vite_Vue3使用Vite构建项目_Vite创建Vue3项目

效率首选的是模板创建,直接执行npm create vite@latest hello-vue3 -- --template vue,便可一步到位。今年1月我给团队新成员配置环境,从安装Node到让项目运行起来一共花费了4分钟,他们还以为我在施展魔术呢。这里要特别留意,Node版本必须在16以上,因为Vite 5已经不再支持14.x,推荐使用18.17.0或20.x版本。

Vite创建Vue3项目_Vue3使用Vite构建项目_编程入门Vite

项目目录结构与各文件作用

cd vite-project              # 切换到项目目录
yarn                         # 安装项目的全部依赖
yarn dev                     # 启动服务

将Vue 3与Vite创建而成的项目,其结构清晰程度颇高。放置favicon.ico这类无需编译的静态资源之地,乃是public目录,在打包之际,会按照原样复制至dist。而src目录是项目的核心区域,其中assets用于存放会被编译的图片以及样式,components则用于放置.vue组件。

App.vue作为根组件,main.js属于入口文件,在此处相较于Vue 2而言多了一步createApp操作。index.html并非处于public里,而是直接放置在根目录,其中存在一个id为app的div等待着被接管。dist目录是在执行build命令之后才会出现的,上线时就上传这个文件夹。yarn.lock或者package-lock.json需要提交到代码库,以此保证所有人的依赖版本保持一致。

开发与构建命令详解

"scripts":{
 "dev": "vite",
 "build":"vite build",
 "preview": "vite preview"
}

启动开发服务器的dev命令,输出生产代码到dist的build命令,在本地模拟生产环境的preview命令,这三个命令最为常用。实际执行的是vite这个底层命令,以及vite build这个底层命令,还有vite preview这个底层命令 ,package.json里的scripts只是做了一层转发。

VITE v4.1.4 ready in 441 ms
Local: http://127.0.0.1:5173/

在2025年的时候,我们所具有的一个项目于上线之前被发现图片路径存在错误情况,在本地进行preview操作之后跑了一遍就就将那个问题予以复现了,并不需要推送到测试环境当中去。这样的一种习惯现如今已经变成了团队的标准流程,每一个开发人员在提测之前都必定要在本地进行build操作,并且要preview,以此来确认没有错误。

编程入门Vite_Vite创建Vue3项目_Vue3使用Vite构建项目

迁移成本与适配现状

将Vue CLI切换至Vite并非毫无成本,老项目运用了诸多Webpack插件,像svg - sprite - loader这类,Vite得寻觅替代办法或者自行编写插件,其环境变量读取方式也存在差异,Vite向客户端暴露的变量必须以VITE_开头。

然而呢,不必抱着旧工具在新项目上执着不放。在2026年的时候,Vue官方文档已然默认推荐Vite,create - vue这条命令在底层调用的正是Vite。社区生态还完全跟了上来,Element Plus、Naive UI这些主流组件库的官方示例都是基于Vite的。你当下打开GitHub上与Vue 3相关的开源项目,十个当中有九个都在使用Vite。

# 使用npm6或更低版本创建项目
npm create vite@latest--template
# 使用npm7或更高版本创建项目
npm create vite@latest ----template 
# 使用yarn create命令创建项目
yarn create vite--template

你于实际开展工作期间,究竟是缘何哪一个痛点,致使你从Webpack转而投向Vite的?是启动之时的速度方面,还是热更新所带来的体验层面,亦或是配置环节的复杂度?欢迎在评论的区域之内分享你自身的迁移经历,倘若觉得这篇文章具备实用价值的话,可要记得点赞并且转发给身旁仍旧在等待Webpack进行编译的同事。

yarn create vite hello-vite --template vue