博客信息

使用vue-cli搭建SPA项目

发布时间:『 2019-07-12 06:46』  博客类别:前端框架  阅读(1002)

0. 前提:搭建好NodeJS环境

   node -v

   npm -v

 

 

1. 什么是vue-cli?

   vue-clivue.js的脚手架,用于自动生成vue.js+webpack的项目模板,创建命令如下:           

   vue init webpack xxx                    

 

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

   2:必须先安装vue,vue-cliwebpacknode等一些必要的环境

 

 

2. 安装vue-cli

   npm install -g vue-cli

 

   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创建一个mavenweb项目

   cmd                                      #打开命令窗口

   d:                                       #切换到d

   cd d:\temp                               #进入d:\temp目录

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

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

  

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

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

        切换回中文:chcp 936

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

 

   2一问一答模式

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

         2.Project description:项目描述,直接回车

         3.Author:作者,随便填或直接回车

         4.Vue build:选择题,一般选第一个

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

           4.2Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specific HTML) are ONLY allowed in .vue files

              - render functions are required elsewhere//仅运行时,已经有推荐了就选择第一个了

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

         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这个文件夹内,然后安装需要的模块

   ## 此步骤可理解成:mavenweb项目创建成功后,修改pom文件添加依赖

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

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

   

  

   ## 步骤三:启动并访问项目

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

   cd spa1

   npm run dev

 

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

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

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

        config --> index.js  

        dev: {

          // Paths

          assetsSubDirectory: 'static',

          assetsPublicPath: '/',

          proxyTable: {},

          host: 'localhost',

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

          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”dependenciesdevdependencies中配置的所有依赖模块,并保存到项目的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.jsondependencies对象,并保存到项目的node_modules目录

        

  5.3 npm install xxx -D

      写入到package.jsondevDependencies对象,并保存到项目的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

 

       

 

  3package.json文件里面的devDependenciesdependencies对象有什么区别呢?

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

       例如:gulp babelwebpack一般都是辅助工具,应该使用--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 里面设置命令以及在dependenciesdevDependencies中,

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

     

 

7. 什么是*.vue文件

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

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

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

 

 

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

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

         <template>

           <div>...</div>

         </template>

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

        <script>

          export default {

             name: 'App'

          }

        </script>

   3:样式与以前的写法一样

 

 

8. 综合案例

   首页-用户中心-用户  

   路由嵌套,关键代码:

     {

path: '/UserCenter',

name: 'UserCenter',

component: UserCenter,

children: [{

path: 'UserInfo',

name: 'UserInfo',

component: UserInfo,

}]

}

   网站公共部分:头部(header.vue)和脚部(footer.vue)的创建和使用

 

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

 

 

   2ES6模块写法

       模块名

         index.js   (模块主文件)

         a.js

         b.js

 

  

附录一:vueimport引入模块路径中@符号是什么意思?

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

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

这个是webpack使用loader里配置的

resolve: {

    // 自动补全的扩展名

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

    // 默认路径代理

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

    alias: {

        '@': resolve('src'),

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

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

    }

}

 

 

附录二:vue.js有著名的全家桶系列

包含了vue-routervuexvue-resource,再加上构建工具vue-cli,就是一个完整的vue项目的核心构成。

但在新版本中vue-resource已被axios替代

 

 

附录三:npm 删除模块

[npm uninstall xxx]删除xxx模块;

[npm uninstall -g xxx]删除全局模块xxx


小李飞刀_Vue



小李飞刀_Vue



小李飞刀_Vue


利用vue-cli脚手架搭建SPA项目成功截图

小李飞刀_Vue

安装element-ui(这里由于网速卡,npm安装始终失败,于是重新搞了一个项目)


小李飞刀_Vue


项目目录结构

小李飞刀_Vue


嵌套路由最终截图

小李飞刀_Vue




改动的相关代码都在这

src.zip 


over......


关键字:     前端框架       Vue       SPA  

备案号:湘ICP备19000029号

Copyright © 2018-2019 javaxl晓码阁 版权所有