Vue 脚手架是 Vue 官方提供的标准化开发工具,它能帮我们快速生成统一规范的 Vue 项目骨架,隐藏复杂的 Webpack 配置,让开发者专注于业务逻辑开发,无需从零搭建工程环境。
Vue 脚手架官方文档可参考:Vue CLI。
全局安装 @vue/cli(仅首次执行)
打开终端/命令提示符工具,执行全局安装命令:
npm install -g @vue/cli
安装完成后,可通过以下命令验证是否安装成功:
vue --version

国内网络环境下下载速度缓慢,可先配置淘宝镜像加速:
npm config set registry https://registry.npmmirror.com

PS:默认官方源是 https://registry.npmjs.org/
创建新项目
通过 cd 命令切换到你想要存放项目的本地目录,然后执行项目创建命令,将 xxxx 替换为你的自定义项目名:
vue create my-vue-project

执行命令后终端会弹出交互式选项菜单,你可以根据需求选择预设配置,比如默认 Vue2/Vue3 模板、手动勾选路由、状态管理等功能,等待依赖自动安装完成,项目骨架就生成好了。

创建项目成功会提示:Successfully created project my-vue-project

启动本地开发服务
进入刚创建完成的项目根目录:
cd my-vue-project
执行启动命令,即可拉起本地开发服务器:
npm run serve

终端会输出本地访问地址,默认一般是 http://localhost:8080,在浏览器打开就能看到 Vue 项目的默认首页。
通过脚手架生成的默认项目,目录结构分工清晰,每个文件和文件夹都有明确的职责:

javascript
├── node_modules 项目所有依赖包的存放目录,由npm自动生成,无需手动修改
├── public 静态资源目录,该目录下的文件不会被Webpack编译
│ ├── favicon.ico 浏览器页签上显示的小图标
│ └── index.html 整个Vue项目的主HTML入口文件,最终Vue应用会挂载到这里
├── src 项目的核心源代码目录,所有业务代码都写在这里
│ ├── assets 存放需要被Webpack编译的静态资源,比如图片、样式文件等
│ │ └── logo.png
│ ├── components 存放可复用的公共组件,不和路由直接绑定
│ │ └── HelloWorld.vue
│ ├── App.vue 项目的根组件,所有页面和组件最终都会汇总到这里
│ └── main.js 项目的入口JS文件,是整个Vue应用启动的起点
├── .gitignore Git版本控制的忽略配置,指定哪些文件不需要提交到代码仓库
├── babel.config.js Babel转译工具的配置文件,用于将ES6+语法转为兼容的低版本JS
├── package.json 项目的应用包配置文件,记录项目信息、脚本命令和依赖清单
├── README.md 项目的说明文档,一般用于记录项目介绍、安装和运行说明
└── package-lock.json 依赖包的版本锁定文件,保证团队协作时
main.js(项目入口文件)
javascript
import Vue from 'vue'
import App from './App.vue'
// 关闭生产环境的提示
Vue.config.productionTip = false
new Vue({
render: h => h(App),
}).$mount('app')
App.vue(根组件示例)
javascript
<template>
<div id="app">
<img src="./assets/logo.png" alt="Vue logo">
<HelloWorld msg="欢迎使用Vue脚手架"/>
</div>
</template>
<script>
import HelloWorld from './components/HelloWorld.vue'
export default {
name: 'App',
components: {
HelloWorld
}
}
</script>
<style>
app {
font-family: Avenir, Helvetica, Arial, sans-serif;
text-align: center;
color: 2c3e50;
margin-top: 60px;
}
</style>
根组件作为所有组件的顶层容器,一般只负责全局布局和公共组件的引入,不会编写具体的业务逻辑。