• Vue-cli 搭建 SPA 项目,Vue 项目结构说明,开发示例,以及如何修改端口号,install 命令中的 -g,-S,-D 参数,嵌套路由,package.json 详解


    目录

    1. vue-cli安装

    1.1 安装前提

    1.2 什么是vue-cli

    1.3 安装vue-cli

    2. 使用vue-cli构建项目

    2.1 使用脚手架创建项目骨架

    2.2 到新建项目目录,安装需要的模块

    2.3 如何修改端口号

    2.4 添加element-ui模块

    2.5 package.json详解

    3. install命令中的-g, -S, -D参数

    4. vue项目结构说明

    5.什么是*.vue文件

    6. 启动过程

    7. 开发示例

    7.1 做一个自定义组件Welcome

    7.2 增加“用户管理”和“关于我们”组件

    7.3 嵌套路由


    1. vue-cli安装

    1.1 安装前提

    在安装vue-cli前需要先确定nodejs环境安装好,验证nodejs环境安装:

    • node -v
    • npm -v

    1.2 什么是vue-cli

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

    vue init webpack xxx
    • xxx 为自己创建项目的名称
    • 必须先安装vue,vue-cli,webpack,node等一些必要的环境

    1.3 安装vue-cli

    命令:

    npm install -g vue-cli

    安装成功后会在配置的node_global\node_modules目录下会看到vue-cli目录。

    在cmd窗口输入如下命令,验证vue安装是否成功,注意:这里的V是大写。如果成功会打印版本号

    vue -V

    2. 使用vue-cli构建项目

    2.1 使用脚手架创建项目骨架

    在cmd命令窗口,到项目存放目录,运行如下命令:

    vue init webpack spa1

    spa1为项目名,根据实现输入即可。

    注1:cmd命令行窗口显示中文乱码,多是因为cmd命令行窗口字符编码不匹配导致, 修改cmd窗口字符编码为UTF-8,命令行中执行:chcp 65001, 切换回中文:chcp 936, 这两条命令只在当前窗口生效,重启后恢复之前的编码。不能管。

    接下来,安装程序会进入一问一答的安装模式:
    1)Project name:项目名,默认是输入时的那个名称spa1,直接回车
    2)Project description:项目描述,直接回车
    3)Author:作者,随便填或直接回车
    4)Vue build:选择题,一般选第一个

    • Runtime + Compiler: recommended for most users //运行加编译,官方推荐
    • Runtime-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-router,Y选择使用,这样生成好的项目就会有相关的路由配置文件
    6)Use ESLint to lint your code:是否用ESLint来限制你的代码错误和风格。N
    7)Setup e2e tests with Nightwatch?:是否安装e2e测试 N
    8)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

    全部选择好回车就进行了生成项目,出现如下内容表示项目创建完成
    #Project initialization finished!
    #========================

    2.2 到新建项目目录,安装需要的模块

    此步骤类似于maven通过pom文件安装依赖。
    命令:

    npm install
    

    需要些流量,请使用速度较好的网络。

    安装完成后,在命令窗口,到项目目录,运行如下命令:

    npm run dev

    运行项目, 出现:Your application is running here: http://localhost:8080,表示运行成功,在浏览器地址栏输入http://localhost:8080即可查看。

    2.3 如何修改端口号

    项目运行时默认使用的是8080端口,如果其他程序也使用该端口则会引发冲突,如果tomcat默认使用的也是8080,为避免冲突需要改变端口号。
    打开项目目录下config/index.js文件,修改dev部分的port即可

    2.4 添加element-ui模块

    添加element-ui时先停掉服务,使用如下命令安装element-ui模块。

    npm install element-ui -S

    注1:使用vue+elementUI创建SPA项目,一般情况下其项目结构组成如下:
    * Vue + ESLint + webpack + elementUI + ES6
    Vue: 主要框架
    * ESLint: 帮助我们检查Javascript编程时的语法错误,这样在一个项目中多人开发,能达到一致的语法
    * Webpack: 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。整个项目中核心配置
    * elementUI: 是基于vue的一套样式框架,里面有很多封装好的组件样式
    * ES6: 全称ECMAScript6.0,是JavaScript的下一个版本标准,2015.06发版

    2.5 package.json详解

    每个项目的根目录下面,一般都有一个package.json文件,定义了这个项目所需要的各种模块,以及项目的配置信息(比如名称、版本、许可证等元数据)。npm install命令根据这个配置文件,自动下载所需的模块,也就是配置项目所需的运行和开发环境。
    详情见资料“package-详解.json”中的相关注释

    3. install命令中的-g, -S, -D参数

    命令含义
    npm install下载“package.json”中dependencies和devdependencies中配置的所有依赖模块,并保存到项目的node_modules目录
    npm install xxx -g全局安装,下载依赖模块,并保存到%node_home%\node_global\node_modules目录下
    npm install xxx -S写入到package.json的dependencies对象,并保存到项目的node_modules目录
    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就会到里面去找需要的函数库,也就是依赖。

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

    命令简称
    installi
    --save-S
    --save-dev-D
    --global-g

    4. vue项目结构说明

    文件夹文件作用
    build这个文件夹主要是进行webpack的一些配置
    webpack.base.conf.jswebpack基础配置,开发环境,生产环境都依赖
    webpack.dev.conf.jswebpack开发环境配置
    webpack.prod.conf.jswebpack生产环境配置
    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.vuevue文件入口界面
    main.js对应App.vue创建vue实例,也是入口文件,对应webpack.base.config.js里的入口配置
    static文件夹存放的文件不会经过webpack处理,可以直接引用,例如swf文件如果要引用可以在webpack配置,对swf后缀名的文件处理的loader,也可以直接将swf文件放在这个文件夹引用
    package.json这个文件有两部分是有用的:scripts 里面设置命令以及在dependencies和devDependencies中,分别对应全局下载和局部下载的依赖包

    5.什么是*.vue文件

    *.vue 文件,是一个自定义的文件类型,用类似HTML的语法描述一个Vue组件。每个.vue文件包含三种类型的顶级语言块