使用vue-cli来搭建vue项目

前提：搭建好NodeJS环境

node -v

npm -v

 

1. 什么是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

npm install -g webpack

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

D:\initPath

　　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”），若是出现相应的版本号，则说明安装成功。

 

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

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

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

cmd 打开命令窗口

d: 切换到d盘

cd d:\temp

进入d:\temp目录

vue init webpack spa1  此命令用于建立SPA项目，它会在当前目录生成一个以“spa1”命名的文件夹

spa1即为项目名，项目名不能用中文或大写字母，而后终端会出现“一问一答”模式(见注2) 

 

注1：cmd命令行窗口显示中文乱码，可能是由于cmd命令行窗口字符编码不匹配致使

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

切换回中文：chcp 936

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

注2：“一问一答”模式

1.Project name：项目名，默认是输入时的那个名称spa1，直接回车

2.Project description：项目描述，直接回车

3.Author：做者，随便填或直接回车

4.Vue build：选择题，通常选第一个

4.1 Runtime + Compiler: recommended for most users//运行加编译，官方推荐，就选它了

4.2 Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specific HTML) are ONLY allowed in .vue filesrender functions are required elsewhere//仅运行时，已经有推荐了就选择第一个了

5. Install vue-router：是否须要vue-router，Y选择使用，这样生成好的项目就会有相关的路由配置文件

6.Use ESLint to lint your code：是否用ESLint来限制你的代码错误和风格。N 新手就不用了，但实际项目中通常都会使用，这样多人开发也能达到一致的语法

7.Set up unit tests：是否安装单元测试 N

8.Setup e2e tests with Nightwatch?：是否安装e2e测试 N

9.Should we run `npm install` for you after the project has been created? (recommended) (Use arrow keys)

> Yes, use NPM 

Yes, use Yarn

No, I will handle that myself //选择题：选第一项“Yes, use NPM”是否使用npm install安装依赖

所有选择好回车就进行了生成项目，出现以下内容表示项目建立完成

Project initialization finished!

========================

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

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

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

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

npm install #安装全部项目须要的npm模块

 

 步骤三：启动并访问项目

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

cd spa1

npm run dev

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

 

 

 

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

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

config --> index.js文件

dev: {

// Paths

assetsSubDirectory: 'static',

assetsPublicPath: '/',

proxyTable: {},

host: 'localhost',

port: 8088, // 在这里修改端口号

autoOpenBrowser: false,

errorOverlay: true,

notifyOnErrors: true,

},

 

步骤四：中止项目添加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的下一个版本标准，2015.06发版

 

4. package.json详解

每一个项目的根目录下面，通常都有一个package.json文件，定义了这个项目所须要的各类模块，

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

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

详情见资料“package-详解.json”中的相关注释

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

5.1 npm install

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

注1：在git clone项目的时候，项目文件中并无node_modules文件夹，为何呢？

5.2 npm install xxx -g

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

5.3 npm install xxx -S

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

 

5.3 npm install xxx -D

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

 

注1：在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

 注3：package.json文件里面的devDependencies和dependencies对象有什么区别呢？devDependencies里面的插件只用于开发环境，不用于生产环境，而dependencies是须要发布到生产环境的。

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

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

 

6. vue项目结构说明

 

build文件夹 这个文件夹主要是进行webpack的一些配置

webpack.base.conf.js webpack基础配置,开发环境,生产环境都依赖

webpack.dev.conf.js webpack开发环境配置

webpack.prod.conf.js webpack生产环境配置

build.js 生产环境构建脚本 vue-loader.conf.js 此文件是处理.vue文件的配置文件

config文件夹

dev.env.js 配置开发环境

prod.env.js 配置生产环境

index.js 这个文件进行配置代理服务器，例如：端口号的修改 

 

node_modules文件夹 存放npm install时根据package.json配置生成的npm安装包的文件夹

src文件夹 源码目录(开发中用得最多的文件夹)

assets 共用的样式、图片

components 业务代码存放的地方，里面分红一个个组件存放，一个页面是一个组件，一个页面里面还会包着不少组件

router 设置路由

App.vue vue文件入口界面

main.js 对应App.vue建立vue实例，也是入口文件，对应webpack.base.config.js里的入口配置

static文件夹 存放的文件不会通过webpack处理，能够直接引用，例如swf文件若是要引用能够在webpack配置

对swf后缀名的文件处理的loader，也能够直接将swf文件放在这个文件夹引用 

 

package.json 这个文件有两部分是有用的：scripts 里面设置命令以及在dependencies和devDependencies中，

分别对应全局下载和局部下载的依赖包

 

 

7. 什么是*.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：样式与之前的写法同样

 

8. 综合案例

写一个简单的嵌套路由案例，主要建立和修改如下文件：

About.vue

<template>
    <div>
        <router-link to="/AboutMe">关于博主</router-link>
        <router-link to="/AboutWebSite">关于网站</router-link>
        <router-view/>
    </div>
</template>

<script> export default{ data(){ return { }; } } </script>

<style>
</style>

AboutMe.vue

<template>
    <div> 显示博主我的资料 </div>
</template>

<script> export default{ data(){ return { }; } } </script>

<style>
</style>

AboutWebSite.vue

<template>
    <div> 显示网站发展历史 </div>
</template>

<script> export default{ data(){ return { }; } } </script>

<style>
</style>

Home.vue

<template>
    <div> 显示博客内容 </div>
</template>

<script> export default{ data(){ return { }; } } </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 About from '@/components/About' import AboutMe from '@/components/AboutMe' import AboutWebSite from '@/components/AboutWebSite' Vue.use(Router) export default new Router({ routes: [{ path: '/', name: 'Home', component: Home }, { path: '/Home', name: 'Home', component: Home }, { path: '/About', name: 'About', component: About, children: [{ path: '/AboutMe', name: 'AboutMe', component: AboutMe }, { path: '/AboutWebSite', name: 'AboutWebSite', component: AboutWebSite } ] } ] })

App.vue

<template>
  <div id="app">
           <!--<img src="./assets/logo.png">-->
        <router-link to="/Home">首页</router-link>
        <router-link to="/About">关于</router-link>
            <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>

效果以下：

 

；