06 使用vue-cli搭建SPA项目

目录

一. 什么是vue-cli?

2. 安装vue-cli(需要联网)

三. 使用脚手架vue-cli(2.X版)来构建项目

步骤一：使用脚手架创建项目骨架

步骤二：运行完上面的命令后，我们需要将当前路径改变到SPA这个文件夹内，然后安装需要的模块

步骤三：启动并访问项目

步骤四：停止项目添加element-ui模块

四. package.json详解

五. npm install/npm install xxx -S/npm install xxx -D/npm install xxx -g的区别

六. vue项目结构说明以及项目启动流程

七. 什么是*.vue文件

八. 综合案例

问题：vue中import引入模块路径中@符号是什么意思？

注意:前提是要搭建好NodeJS环境

黑窗口测试一下

node -v

npm -v

没有搭建好的话无法进行下面的步骤

测试好了的话就可以进入这一篇章了！！！！

一. 什么是vue-cli?

vue-cli是vue.js的脚手架，用于自动生成vue.js+webpack的项目模板，创建命令如下：

vue init webpack xxx

注1：xxx 为自己创建项目的名称

注2：必须先安装vue,vue-cli，webpack，node等一些必要的环境

2. 安装vue-cli(需要联网)

npm install -g vue-cli

注1：安装成功后，会出现如下文件

d:\tools ==> 根据自行安装的目录来操作

node-v10.15.3-win-x64

node_global

vue

vue.cmd

vue-init

vue-init.cmd

vue-list

vue-list.cmd

注2：安装完成之后打开命令窗口并输入 vue -V（注意这里是大写的“V”），如果出现相应的版本号，则说明安装成功。

三. 使用脚手架vue-cli(2.X版)来构建项目

步骤一：使用脚手架创建项目骨架

此步骤可理解成：使用eclipse创建一个maven的web项目

这里我们用黑窗口创建

d: //切换到d盘

cd d:\temp //进入d:\temp目录 shift+insert快速赋值

vue init webpack spa1 //此命令用于创建SPA项目，它会在当前目录生成一个以“spa1”命名的文件夹，spa1即为项目名，项目名不能用中文或大写字母，然后终端会出现“一问一答”模式

注：cmd命令行窗口显示中文乱码，多是因为cmd命令行窗口字符编码不匹配导致

修改cmd窗口字符编码为UTF-8，命令行中执行：chcp 65001

切换回中文：chcp 936

这两条命令只在当前窗口生效，重启后恢复之前的编码

黑窗口最上面绿色问号的九个问题（一问要答模式）

全部选择好回车就进行了生成项目，出现如下内容表示项目创建完成

# Project initialization finished!

# ========================

实在不会选，就回车选择“默认”或是选择“N”不安装

如果在这里直接启动项目的话会报以下错误 也就是步骤二的作用

原因是package.json所在目录不是现在所访问的目录，而是在这个目录里面的一个目录里

步骤二：运行完上面的命令后，我们需要将当前路径改变到SPA这个文件夹内，然后安装需要的模块

此步骤可理解成：maven的web项目创建成功后，修改pom文件添加依赖

cd spa1 #改变路径到spa1文件夹下

npm install#安装所有项目需要的npm模块

步骤三：启动并访问项目

## 此步骤可理解成：启动tomcat，并通过浏览器访问项目

cd spa1

npm run dev

黑窗口执行

页面显示 端口号:http://localhost:8080(需要更改)

注1：项目启动成功后，打开浏览器输入“http://localhost:8080”即可

注2：vue-cli构建的项目，在控制台npm run dev启动后，默认的调试地址是8080端口的但是大部分时候，

我们都要并行几个项目开发，很有可能已经占用了8080端口，所以就涉及到如何去更改调试地址的端口号了

将spa项目拖进HBuilder 打开 config --> index.js

更改port端口号为8083

点击运行-->运行到终端-->选中npm run dev-->外部终端

打开黑窗口后复制端口号到浏览器

步骤四：停止项目添加element-ui模块

cd spa1

npm install element-ui -S #-S就是-save的缩写

注1：使用vue+elementUI创建SPA项目，一般情况下其项目结构组成如下：

Vue + ESLint + webpack + elementUI + ES6

Vue:主要框架

ESLint:帮助我们检查Javascript编程时的语法错误，这样在一个项目中多人开发，能达到一致的语法

Webpack:设置代理、插件和loader处理各种文件和相关功能、打包等功能。整个项目中核心配置

elementUI:是基于vue的一套样式框架，里面有很多封装好的组件样式

ES6:全称ECMAScript6.0，是JavaScript的下一个版本标准，.06发版

四. package.json详解

每个项目的根目录下面，一般都有一个package.json文件，定义了这个项目所需要的各种模块，

以及项目的配置信息（比如名称、版本、许可证等元数据）。npm install命令根据这个配置文件，

自动下载所需的模块，也就是配置项目所需的运行和开发环境

package.json

{"name": "spa1", //项目名称:1.name中不能包含大写字母name;2.不能以"."(点)或者"_"(下划线)开头"version": "1.0.0", //项目版本"description": "A Vue.js project", //项目描述"author": "", //作者"private": true, //如果你不希望授权别人以任何形式使用私有包或未发布的包，设为true这个包将不会发布到NPM平台下"scripts": { //指定了运行脚本命令的npm命令行缩写，比如push指定了运行npm run dev时，所要执行的命令"dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js","start": "npm run dev","build": "node build/build.js"},"dependencies": { //指定依赖的其它包，这些依赖是指包发布后正常执行时所需要的，也就是线上需要的包。它们将会被安装在node_module目录下"element-ui": "^2.9.1","vue": "^2.5.2","vue-router": "^3.0.1"},"devDependencies": { //开发环境依赖包列表。这些依赖只有在开发时候才需要，它们将会被安装在node_module目录下//NPM使用语义版本号来管理代码，语义版本号分为X.Y.Z三位，分别代表主版本号、次版本号和补丁版本号//当代码变更时，版本号按以下原则更新。// 1.如果只是修复bug，需要更新Z位。// 2.如果是新增了功能，但是向下兼容，需要更新Y位。// 3.如果有大变动，向下不兼容，需要更新X位//version，必须匹配某个版本，如：1.1.2，表示必须依赖1.1.2版//>version，必须大于某个版本，如：>1.1.2，表示必须大于1.1.2版//~version，大概匹配某个版本，~1.1.2，表示>=1.1.2 <1.2.0//^version，兼容某个版本，如：^1.1.2 ，表示>=1.1.2 <2.0.0"autoprefixer": "^7.1.2","babel-core": "^6.22.1","babel-helper-vue-jsx-merge-props": "^2.0.3","babel-loader": "^7.1.1","babel-plugin-syntax-jsx": "^6.18.0","babel-plugin-transform-runtime": "^6.22.0","babel-plugin-transform-vue-jsx": "^3.5.0","babel-preset-env": "^1.3.2","babel-preset-stage-2": "^6.22.0","chalk": "^2.0.1","copy-webpack-plugin": "^4.0.1","css-loader": "^0.28.0","extract-text-webpack-plugin": "^3.0.0","file-loader": "^1.1.4","friendly-errors-webpack-plugin": "^1.6.1","html-webpack-plugin": "^2.30.1","node-notifier": "^5.1.2","optimize-css-assets-webpack-plugin": "^3.2.0","ora": "^1.2.0","portfinder": "^1.0.13","postcss-import": "^11.0.0","postcss-loader": "^2.0.8","postcss-url": "^7.2.1","rimraf": "^2.6.0","semver": "^5.3.0","shelljs": "^0.7.6","uglifyjs-webpack-plugin": "^1.1.1","url-loader": "^0.5.8","vue-loader": "^13.3.0","vue-style-loader": "^3.0.1","vue-template-compiler": "^2.5.2","webpack": "^3.6.0","webpack-bundle-analyzer": "^2.9.0","webpack-dev-server": "^2.9.1","webpack-merge": "^4.1.0"},"engines": { //指定包运行的环境 jdk1.8+tomcat8.5"node": ">= 6.0.0","npm": ">= 3.0.0"},//根据提供的目标浏览器的环境来，智能添加css前缀，js的polyfill垫片,来兼容旧版本浏览器//last 2 versions：追踪的IE最新版本为11,向后兼容两个版本即为10、11"browserslist": ["> 1%","last 2 versions","not ie <= 8"]}

五. npm install/npm install xxx -S/npm install xxx -D/npm install xxx -g的区别

5.1 npm install

下载“package.json”中dependencies和devdependencies中配置的所有依赖模块，并保存到项目的node_modules目录

5.2 npm install xxx -g -g==global

全局安装，下载依赖模块，并保存到%node_home%\node_global\node_modules目录下

5.3 npm install xxx -S

写入到package.json的dependencies对象，并保存到项目的node_modules目录

5.4 npm install xxx -D

写入到package.json的devDependencies对象，并保存到项目的node_modules目录

问题：在git clone项目的时候，项目文件中并没有node_modules文件夹，为什么呢？

我们知道这个文件中(project_home\node_modules)保存的是我们项目开发中所使用的依赖模块。这个文件夹可能有几百兆大小，

如果放到github上，其它人clone的时候会非常慢，这个时候就想到用一个package.json依赖配置文件解决这个问题。

这样每个人下载这个项目的时候，只需要进入该项目目录直接npm install npm就会到里面去找需要的函数库，也就是依赖。

注2：缩写命令的全称，注意大小写、-S,-D都是大写

i/install

-S/--save

-D/--save-dev

-g/--global

问题：package.json文件里面的devDependencies和dependencies对象有什么区别呢？

devDependencies里面的插件只用于开发环境，不用于生产环境，而dependencies是需要发布到生产环境的。

例如：gulp ，babel，webpack一般都是辅助工具，应该使用--save-dev安装到开发环境

例如：vue ,react，应该使用--save 安装到生产环境

六. vue项目结构说明以及项目启动流程

build文件夹

config文件夹

node_modules文件夹

src文件夹

static文件夹

SPA项目启动流程图(可以根据下面的示例配合理解)

七. 什么是*.vue文件

*.vue 文件，是一个自定义的文件类型，用类似HTML的语法描述一个Vue组件。

每个.vue文件包含三种类型的顶级语言块 <template>, <script> 和 <style>。

这三个部分分别代表了 html,js,css。

注1：不能直接把html代码包裹在<template></template>中，而是必须在里面方置一个html标签来包裹所有的代码。

一般情况是使用<div></div>标签包含其它的代码(保证只有一个根元素)

<template>

<div>...</div>

</template>

注2：js代码写在<script>标签中，并通过export导出

<script>

export default {

name: 'App'

}

</script>

注3：样式与以前的写法一样

八. 综合案例

首页-用户中心-用户

路由嵌套，关键代码：

{

path: '/UserCenter',

name: 'UserCenter',

component: UserCenter,

children: [{

path: 'UserInfo',

name: 'UserInfo',

component: UserInfo,

}]

}

注1：以 " / " 开头的嵌套路径会被当作根路径，所以子路由的 path 不需要添加 " / "

代码演示（可以根据上面的流程图来配合理解）

自定义组件，也就是.vue

Home.vue

<template><!-- 有且只有一个根节点 --><div><h1>{{ts}} - {{msg}}</h1><div><router-link to="/UserInfo">用户中心</router-link><router-link to="/About">关于我们</router-link></div><div><router-view/></div></div></template><script>export default{name:'Home',data:function(){return {ts:new Date().getTime(),msg:'hello Vue!!!'}},methods:{}}</script><style></style>

UserInfo.vue

<template><div><h1>用户中心</h1><div><router-link to="/Update">修改密码</router-link><router-link to="/Cancel">注销</router-link></div><div><router-view/></div></div></template><script>export default{name:'UserInfo',data:function(){return{}},methods:{}}</script><style></style>

About.vue

<template><div><h1>关于我们</h1></div></template><script>export default{name:'About',data:function(){return{}},methods:{}}</script><style></style>

Update.vue

<template><div><h1>修改密码</h1></div></template><script>export default{name:'Update',data:function(){return{}},methods:{}}</script><style></style>

Cancel.vue

<template><div><h1>注销</h1></div></template><script>export default{name:'Cancel',data:function(){return{}},methods:{}}</script><style></style>

路由器（index.js）

import Vue from 'vue'import Router from 'vue-router'import HelloWorld from '@/components/HelloWorld'import Home from '@/components/Home'import UserInfo from '@/components/UserInfo'import About from '@/components/About'import Cancel from '@/components/Cancel'import Update from '@/components/Update'//import AddBook from '@/views/book/AddBook'Vue.use(Router)export default new Router({routes: [{path: '/HelloWorld',name: 'HelloWorld',component: HelloWorld},{path: '/',name: 'Home',component: Home,children:[{path: 'UserInfo',name: 'UserInfo',component: UserInfo,children:[{path: '/Update',name: 'Update',component: Update},{path: '/Cancel',name: 'Cancel',component: Cancel}]}, {path: 'About',name: 'About',component: About} ]}]})

main.js

// The Vue build version to load with the `import` command// (runtime-only or standalone) has been set in webpack.base.conf with an alias.import Vue from 'vue'import App from './App'import router from './router'/* @和.的区别@表示src根路径下.代表当前路径*/Vue.config.productionTip = false/* eslint-disable no-new */new Vue({el: '#app',router,components: { App },//局部组件定义template: '<App/>'})

App.vue

<template><div id="app"><img src="./assets/logo.png"><router-view/></div></template><script>export default {name: 'App'}</script><style>#app {font-family: 'Avenir', Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;text-align: center;color: #2c3e50;margin-top: 60px;}</style>

双层嵌套效果图

问题：vue中import引入模块路径中@符号是什么意思？

例如：import model from "@/common/model"，这里路径前面的“@”符号表示什么意思？

答案：@等价于/src这个目录，避免写麻烦又易错的相对路径

这个是webpack使用loader里配置的

resolve: {

// 自动补全的扩展名

extensions: ['.js', '.vue', '.json'],

// 默认路径代理

// 例如 import Vue from 'vue'，会自动到 'vue/dist/mon.js'中寻找

alias: {

'@': resolve('src'),

'@config': resolve('config'),

'vue$': 'vue/dist/mon.js'

}

}

如果作者大大有什么问题欢迎私信作者哦！