安装vue-cli
打开 cmd 命令行工具,输入npm install -g vue-cli
,回车 全局安装vue-cli
(注:npm 会有点慢,建议更改为国内淘宝的镜像,只换源即可。在cmd输入命令:
npm config set registry https://registry.npm.taobao.org
构建vue-cli项目
创建项目
通常创建vue-cli项目都是使用的webpack
模版,在这里我们也使用webpack
模版来创建项目。使用其他模版的请参考 这里。
打开cmd,进入想要创建项目的目录下,输入:
vue init webpack projectname
webpack 默认是安装2.0
版本,若要安装1.0
版本,需在 webpack 后面加上版本号信息,
vue init webpack project-name
projextname
是自定义的项目名称,例:我这里命名为vuedemo
命令输入完成后敲回车,此时会自动下载 webpack
模板,稍微等待一会,会让你按提示完成项目的创建,如下图
Project name // 项目名称
Project description // 项目描述
Author // 作者
Vue build // 构建模式,一般默认选择第一种
Install vue-router? // 是否安装引入 vue-router,这里选是,vue-router 是路由组件,后面构建项目会用到
Use ESLint to lint your code? // 建议使用,开发可能会慢一些,但是容易排错
Setup unit tests with Karma + Mocha 以及Setup e2e tests with Nightwatch 这两个是测试,可以不用安装
安装依赖
项目创建完成,打开文件夹可以看到目录结构。
此时,项目已经初具雏形,但还未安装依赖,需打开 cmd,进入项目所在根目录下,输入npm install
,回车。
我们此时再打开项目文件夹,可以看到多了node_modules
文件夹,里面是各种需要的依赖包。
运行项目
打开 cmd,进入到项目所在目录下,输入npm run dev
,回车,启动项目
完成后,浏览器会自动打开,监听端口8080
.
项目结构
总体结构
一个vue-cli
的项目结构如下:
build
build
文件主要是webpack
的配置,主要启动文件是dev-server.js
,当我们输入npm run dev
首先启动的就是dev-server.js
,它会去检查 node
及npm
版本,加载配置文件,启动服务。
config
config
文件主要是项目相关配置,我们常用的就是当端口冲突时配置监听端口,打包输出路径及命名等
node_modules
node_modules
里面是项目依赖包,其中包括很多基础依赖,自己也可以根据需要安装其他依赖。安装方法为打开 cmd,进入项目目录,输入npm install [依赖包名称]
,回车。
在两种情况下我们会自己去安装依赖:
项目运行缺少该依赖包:例如项目加载外部css会用到的
css-loader
,路由跳转vue-loader
等(安装方法示例:npm install css-loader
)安装插件:如
vux
(基于WEUI的移动端组件库),vue-swiper
(轮播插件)
注:有时会安装指定依赖版本,需在依赖包名称后加上版本号信息,如安装 11.1.4 版本的
vue-loader
,输入npm install vue-loader@11.1.4
src
项目核心文件前面已经进行了简单的说明,接下来重点讲解main.js
,App.vue
,及router
的index.js
index.html
index.html
如其他 html一样,但一般只定义一个空的根节点,在main.js
里面定义的实例将挂载在根节点下,内容都通过 vue 组件来填充
App.vue
一个 vue 页面通常由三部分组成:模板(template)
、js(script)
、样式(style)
【template】
其中模板只能包含一个父节点,也就是说顶层的div
只能有一个(例如下图,父节点为#app
的div
,其没有兄弟节点)
<router-view></router-view>
是子路由视图,后面的路由页面都显示在此处.
打一个比方吧,<router-view>
类似于一个插槽,跳转某个路由时,该路由下的页面就插在这个插槽中渲染显示.
【script】
vue 通常用es6
来写,用export default
导出,其下面可以包含数据data
,生命周期(mounted等)
,方法(methods)
等,具体语法请看 vue.js 文档。
【style】
样式通过标签<style></style>
包裹,默认是影响全局的,如需定义作用域只在该组件下起作用,需在标签上加scoped
,<style scoped></style>
如要引入外部 css 文件,首先需给项目安装css-loader
依赖包,打开 cmd,进入项目目录,输入npm install css-loader
,回车。安装完成后,就可以在 style 标签下import
所需的 css 文件,例如:
<style>
import './assets/css/public.css'
</style>
这样,我们就可以把 style 下的样式封装起来,写到 css 文件夹,再引入到页面使用,整个 vue 页面也看上去更简洁。
main.js
main.js
主要是引入 vue 框架,根组件及路由设置,并且定义 vue 实例,下图中的
components:{App}
就是引入的根组件App.vue
后期还可以引入插件,当然首先得安装插件。
router
router
文件夹下,有一个index.js
,即为路由配置文件
这里定义了路径为/
的路由,该路由对应的页面是Hello
组件,所以当我们在浏览器url
访问http://localhost:8080/#/
时就渲染的Hello
组件
类似的,我们可以设置多个路由,/index
,/list
之类的,当然首先得引入该组件,再为该组件设置路由。