vue-cli 2.9.3 详细教程
一、安装vue-cli
1.使用npm全局安装vue-cli(前提是你已经安装了nodejs,否则你连npm都用不了),命令如下:
npm install vue-cli -g
.
2.可以用vue -V来进行查看 vue-cli的版本号。注意这里的V是大写的。如果vue -V的命令能显示版本号,说明已经顺利的把vue-cli安装到我们的计算机里了。
.
3.同时在C:\Users\xxx\AppData\Roaming\npm目录下为会生成几个文件:
二、初始化项目
1.用vue init命令来初始化项目:
vue init <template-name> <project-name>
<template-name>
:表示模板名称,vue-cli官方为我们提供了5种模板
webpack
: 一个全面的webpack+vue-loader的模板,功能包括热加载,linting,检测和CSS扩展。webpack-simple
: 一个简单webpack+vue-loader的模板,不包含其他功能,让你快速的搭建vue的开发环境。browserify
: 一个全面的Browserify+vueify 的模板,功能包括热加载,linting,单元检测。browserify-simple
: 一个简单Browserify+vueify的模板,不包含其他功能,让你快速的搭建vue的开发环境。simple
: 一个最简单的单页应用模板。
<project-name>
:表示项目名称,这个你可以根据自己的项目来起名字
.
2.在实际开发中,一般我们都会使用webpack这个模板,那我们这里也安装这个模板,在命令行输入以下命令:
vue init webpack vuecli_demo
输入命令后,会询问我们几个简单的选项,我们根据自己的需要进行填写就可以了。
Project name
:项目名称 ,如果不需要更改直接回车就可以了。注意:这里不能使用大写Project description
:项目描述,默认为A Vue.js project,直接回车,不用编写。Author
:作者,如果你有配置git的作者,他会读取。Install vue-router?
:是否安装vue的路由插件,我们这里需要安装,所以选择yUse ESLint to lint your code?
:是否用ESLint来限制你的代码错误和风格。我们这里不需要输入n,如果你是大型团队开发,最好是进行配置。setup unit tests with Karma + Mocha?
::是否需要安装单元测试工具Karma+Mocha,我们这里不需要,所以输入n。Setup e2e tests with Nightwatch?
:是否安装e2e来进行用户行为模拟测试,我们这里不需要,所以输入n。
等待一段时间后,安装成功显示如下:
.
3.进入项目目录 cd vuecli_demo
目录结构如下
.
4.npm run dev(或npm start) 开发模式下运行我们的程序。给我们自动构建了开发用的服务器环境和在浏览器中打开,并实时监视我们的代码更改,即时呈现给我们。
.
5.如果想要执行完npm run dev(或npm start) 后能自动打开网页,则需要进行如下设置:
三、Vue-cli项目结构讲解
由于版本实时更新和你选择安装的不同(这里列出的是模板为webpack的目录结构),所以你看到的有可能和下边的有所差别。
以下项目结构是aaa@qq.com版本
|-- build // 项目构建(webpack)相关代码
| |-- build.js // 生产环境构建代码
| |-- check-version.js // 检查node、npm等版本
| |-- logo.png // logo图片
| |-- utils.js // 构建工具相关
| |-- vue-loader.conf.js // vue-loader配置
| |-- webpack.base.conf.js // webpack基础配置
| |-- webpack.dev.conf.js // webpack开发环境配置
| |-- webpack.prod.conf.js // webpack生产环境配置
|-- config // 项目开发环境配置
| |-- dev.env.js // 开发环境配置
| |-- index.js // 项目主要配置(包括监听端口,打包路径等)
| |-- prod.env.js // 生产环境配置
|-- src // 源码目录
| |-- assets // 静态资源
| |-- components // vue公共组件
| |-- router // vue路由
| |-- App.vue // 页面入口文件
| |-- main.js // 程序入口文件,加载各种公共组件
|-- static // 静态文件,比如一些图片,json数据等
| |-- data // 群聊分析得到的数据用于数据可视化
|-- .babelrc // ES6语法编译配置
|-- .editorconfig // 定义代码格式
|-- .gitignore // git上传需要忽略的文件格式
|-- .postcssrc.js // post-loader的插件配置文件
|-- index.html // 入口页面
|-- package.json // 项目基本信息
|-- package-lock.json // 锁定当前安装的包的依赖
|-- README.md // 项目说明
1.build——[webpack配置]
build文件主要是webpack的配置,主要启动文件是webpack.dev.conf.js,当我们输入npm run dev首先启动的就是webpack.dev.conf.js,它会去检查node及npm版本,加载配置文件,启动服务。
.
2.config——[vue项目配置]
config文件主要是项目相关配置,我们常用的就是当端口冲突时配置监听端口,打包输出路径及命名等
.
3.node_modules——[依赖包]
node_modules里面是项目依赖包,其中包括很多基础依赖,自己也可以根据需要安装其他依赖。安装方法为打开cmd,进入项目目录,输入npm install [依赖包名称],回车。
在两种情况下我们会自己去安装依赖:
(1)项目运行缺少该依赖包:例如项目加载外部css会用到的css-loader,路由跳转vue-loader等(安装方法示例:npm install css-loader)
(2)安装插件:如vux(基于WEUI的移动端组件库),vue-swiper(轮播插件)
注:有时会安装指定依赖版本,需在依赖包名称后加上版本号信息,如安装11.1.4版本的vue-loader,输入npm install aaa@qq.com
.
4.src——[项目核心文件]
项目核心文件前面已经进行了简单的说明,接下来重点讲解main.js和router
main.js——[入口文件]
主要是引入vue框架,根组件及路由设置,并且定义vue实例,
下图中的components:{App}就是引入的根组件App.vue
后期还可以引入插件,当然首先得安装插件。
router——[路由配置]
router文件夹下,有一个index.js,即为路由配置文件
这里定义了路径为’/’的路由,该路由对应的页面是Hello组件,所以当我们在浏览器url访问http://localhost:8080/#/时就渲染的Hello组件
类似的,我们可以设置多个路由,‘/index’,’/list’之类的,当然首先得引入该组件,再为该组件设置路由。
打包上线
项目开发完成之后,可以输入 npm run build 来进行打包工作
npm run build
但在这之前需要修改一下配置文件 config\index.js
将 build 的路径前缀修改为 ’ ./ ‘(原本为 ’ / ‘),是因为打包之后,外部引入 js 和 css 文件时,如果路径以 ’ / ’ 开头,在本地是无法找到对应文件的(服务器上没问题)。所以如果需要在本地打开打包后的文件,就得修改文件路径。
修改并执行完 npm run build 后,目录中会新生成 dist 文件夹,可以直接打开本地文件查看。
项目上线时,只需要将 dist 文件夹放到服务器就行了。
完~