准备工作:先装 Node.js 和包管理器
Vue 模板的安装依赖 Node.js 环境。前往 Node.js 官网下载 LTS 版本安装包,安装完成后在终端执行 node -v 和 npm -v,能输出版本号即表示成功。
npm 随 Node.js 一起安装。如果习惯更快的依赖下载速度,可以额外安装 pnpm 或 yarn,但本教程以 npm 为主,命令通用。
方式一:用 Vue CLI 安装模板
Vue CLI 是官方长期维护的脚手架工具,适合需要 Webpack 配置能力的项目。
安装脚手架
npm install -g @vue/cli
安装后执行 vue --version 验证。
创建项目
vue create my-vue-app
终端会提示选择预设。新手可直接选 Default (Vue 3),需要自定义 Babel、Router、状态管理时选 Manually select features。
启动项目
cd my-vue-app
npm run serve
浏览器访问终端提示的地址,看到默认页面即安装成功。
方式二:用 Vite 安装模板(推荐)
Vite 启动速度快,是目前 Vue 官方推荐的方式。
npm create vue@latest
按提示输入项目名,并选择是否需要 Router、Pinia、ESLint 等选项。随后执行:
cd 项目名
npm install
npm run dev
这样就能得到一个结构清晰的 Vue 3 模板。如果只想用最精简的模板,也可以运行 npm create vite@latest my-app -- --template vue,快速生成基础项目。
目录结构与关键文件
安装完成后,先认识几个核心文件:
index.html:页面入口,挂载点通常是src/main.js:创建应用实例并挂载src/App.vue:根组件,模板、逻辑、样式写在一起vite.config.js或vue.config.js:构建配置
理解这几个文件,后续改模板就不会迷路。
常见报错与处理
命令找不到:全局包未加入 PATH,重开终端或检查 npm 全局目录。
依赖安装失败:多为网络问题,可切换镜像源后重试。
端口被占用:Vite 会自动换端口,Vue CLI 可在启动命令后加 --port 8081。
Node 版本过低:升级到 LTS 版本,Vue 3 与 Vite 对旧版本支持有限。
小结
Vue 模板安装的核心就两步:装好 Node.js,选 Vue CLI 或 Vite 创建项目。新项目优先用 Vite,速度快、配置少;需要深度定制 Webpack 时再用 Vue CLI。装完后熟悉 main.js 和 App.vue,就可以开始写第一个组件了。

