webpack+vue项目实战（一,搭建运行环境和相关配置）

时间  2019-11-05 标签 webpack+vue webpack vue 项目 实战 搭建 运行 环境 相关 配置

1.前言

如今正在开发一个公司的后台管理项目，项目是一个单页面应用。功能上就是管理销售订单的各个环节，包括物流管理，回款管理，订单管理等等的功能。这些就很少说了。项目是，基于webpack3,vue2.2.6,element2.2.9。js语法是使用es6,还有使用到的一些资源好比，vue-router,vue-resource,webpack-dev-server等。运行环境是node6.10.0,npm3.10.10，其它版本的小小伙伴要注意版本兼容的问题喔！css

2.package.json

好了，首页在建立项目目录（admin），下面进行项目的第一步，搭建环境。搭建环境的第一步，就是建立package.json，我如今就是简单粗暴的建立发-从以前的项目拷贝一个这样的文件，而后再改一下，代码就是下面这样。你们也能够$ npm init生成这个文件，而后再安装相关的依赖。html

{
  "name": "admin",
  "version": "1.0.0",
  "description": "后台管理系统",
  "dependencies": {},
  "devDependencies": {
    "babel-cli": "^6.10.1",
    "babel-core": "^6.14.0",
    "babel-loader": "^7.0.0",
    "babel-preset-es2015": "^6.9.0",
    "babel-preset-stage-0": "^6.5.0",
    "babel-register": "^6.18.0",
    "browser-sync": "^2.18.2",
    "css-loader": "^0.25.0",
    "ejs-compiled-loader": "^2.1.1",
    "element-ui": "1.2.9",
    "extract-text-webpack-plugin": "^1.0.1",
    "file-loader": "^0.9.0",
    "glob": "^7.0.6",
    "gulp": "^3.9.1",
    "gulp-file-include": "^1.0.0",
    "html-loader": "^0.4.3",
    "html-webpack-plugin": "^2.28.0",
    "node-sass": "^3.7.0",
    "raw-loader": "^0.5.1",
    "sass-loader": "^4.0.2",
    "scss-loader": "0.0.1",
    "style-loader": "^0.13.1",
    "tween.js": "^16.6.0",
    "url-loader": "^0.5.7",
    "vue": "2.2.6",
    "vue-loader": "^10.0.2",
    "vue-resource": "^1.0.3",
    "vue-router": "^2.4.0",
    "vue-style-loader": "^1.0.0",
    "vue-template-compiler": "2.2.6",
    "vuex": "^2.0.0",
    "webpack": "^3.0.0",
    "webpack-dev-server": "^2.4.5"
  },
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "dev": "webpack-dev-server --hot --inline"
  },
  "author": "chen",
  "license": "ISC"
}

有了上面的配置，在命令行输入$ npm install就能够安装相关的依赖了！vue

(vue，vue-template-compiler，element-ui这几个配置的版本号前面是没有^，这是由于项目上，我不须要再更新这些资源了，由于以前试过，由于版本更新了的问题，致使element显示不正常，因此，就固定住了这几个的版本！还有一个就是，这个是一个json文件，不能在这里写注释喔！不然会报错！)node

安装完了以后，项目目录应该是这样的。
clipboard.pngwebpack

.idea是我用webStorm编辑器开发，自动生成的文件
node_modules是安装以后生成的node模块文件，
.npmrc是使用淘宝的镜像的文件，内容以下es6

registry = http://registry.npm.taobao.org
sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

3.webpack.config.babel.js

配置完了package.json以后，下面写webpack的配置文件（webpack.config.babel.js）了。web

webpack.config.babel.js，这样命名是想让webpack在编译的时候自动识别es6的语法，如今貌似不须要这样命名了，以前用webpack1.x的时候貌似是须要的vue-router

webpack的配置，以前说过，也写过文章，这里就当简单复习一下，我就不一块块的说了，直接在代码那里写上注释。代码以下vuex

let path = require('path');
let webpack = require('webpack');
/*
 html-webpack-plugin插件，webpack中生成HTML的插件，
 具体能够去这里查看https://www.npmjs.com/package/html-webpack-plugin
 */
let HtmlWebpackPlugin = require('html-webpack-plugin');
/*
 webpack插件，提取公共模块
 */
let CommonsChunkPlugin = webpack.optimize.CommonsChunkPlugin;
let config = {
    //入口文件配置
    entry: {
        index: path.resolve(__dirname, 'src/js/page/index.js'),
        vendors: ['vue', 'vue-router','vue-resource','vuex','element-ui','element-ui/lib/theme-default/index.css'] // 须要进行单独打包的文件
    },
    //出口文件配置
    output: {
        path: path.join(__dirname, 'dist'), //输出目录的配置，模板、样式、脚本、图片等资源的路径配置都相对于它
        publicPath: '/dist/',                //模板、样式、脚本、图片等资源对应的server上的路径
        filename: 'js/[name].js',            //每一个页面对应的主js的生成配置
        chunkFilename: 'js/[name].asyncChunk.js?'+new Date().getTime() //chunk生成的配置
    },
    module: {
        //加载器
        rules: [
            {
                test: /\.vue$/,
                loader: 'vue-loader',
                options: {
                    loaders: {
                        scss: 'vue-style-loader!css-loader!sass-loader', // <style lang="scss">
                        sass: 'vue-style-loader!css-loader!sass-loader?indentedSyntax' // <style lang="sass">
                    }
                }
            },
            {
                test: /\.html$/,
                loader: "raw-loader"
            },
            {
                test: /\.css$/,
                loader: 'style-loader!css-loader'
            },
            {
                test: /\.js$/,
                exclude: /node_modules/,
                loader: "babel-loader",
                options: {
                    presets: ["es2015","stage-0"],
                    plugins: ['syntax-dynamic-import']
                }
            },
            {
                test: /\.scss$/,
                loader: 'style-loader!css-loader!sass-loader'
            },
            {
                test: /\.(eot|svg|ttf|woff|woff2)(\?\S*)?$/,
                loader: 'file-loader'
            },
            {
                //图片加载器，雷同file-loader，更适合图片，能够将较小的图片转成base64，减小http请求
                //以下配置，将小于8192byte的图片转成base64码
                test: /\.(png|jpg|gif)$/,
                loader: 'url-loader?limit=8192&name=images/[hash].[ext]'
            }
        ]
    },
    //插件
    plugins: [
        //webpack3.0的范围提高
        new webpack.optimize.ModuleConcatenationPlugin(),
        //打包生成html文件，而且将js文件引入进来
        new HtmlWebpackPlugin({
            filename: path.resolve(__dirname, 'dist/html/index.html'), //生成的html存放路径，相对于path
            template: path.resolve(__dirname, 'src/html/index.html'), //ejs模板路径,前面最好加上loader用于处理
            inject: 'body',  //js插入的位置，true/'head'/'body'/false
            hash: true
        }),
        //提取功能模块
        new CommonsChunkPlugin({
            name: 'vendors', // 将公共模块提取，生成名为`vendors`的chunk
            minChunks: 2, //公共模块被使用的最小次数。配置为2，也就是同一个模块只有被2个之外的页面同时引用时才会被提取出来做为common chunks
            // children:true  //若是为true,那么公共组件的全部子依赖都将被选择进来
        }),
    ],
    //使用webpack-dev-server，启动热刷新插件
    devServer: {
        contentBase: path.join(__dirname, "/"),
        host: 'localhost',  //建议写IP地址，开发时候电脑的ip地址。localhost我不知道是幻觉仍是怎样，有时候热刷新不灵敏
        port: 9090, //默认9090
        inline: true, //能够监控js变化
        hot: true//热启动
    },
    //搜索路径变量
    resolve: {
        alias: {
            vue: 'vue/dist/vue.js'
        },
        extensions:['.js','.scss','.vue','.json']// 能够不加后缀, 直接使用 import xx from 'xx' 的语法
    }
};
module.exports = config;

4.vue-router

写好package.json和webpack的配置以后，接下来就是路由(vue-router)了。这一步应该说是准备步骤，为下一步作准备的，方便测试。
1.首页建立一个配置路由的文件以及一个基本的组件文件（方便测试），welcome.vue（这个组件文件只有一张图片，样式也很简单），建立完了以后，目录是这样的。你们要注意这个目录的文件。npm

clipboard.png

clipboard.png
附上代码

<template>
    <div class="welcome-wrap">
        <img src="http://i1.buimg.com/1949/43ab520761604482.jpg" alt="">
    </div>
</template>
<script>
    export default{
        data(){
            return{
                name:'welcome'
            }
        }
    }
</script>
<style lang="scss" scoped>
    .welcome-wrap{
        height: 100%;
        width: 100%;
        img{
            display: block;
            width: 100%;
            height: 100%;
        }
        .hd{
            font-size: 30px;
            text-align: center;
        }
        .bd{

        }
    }
</style>
<style lang="scss">
    .welcome-steps{
        .el-step__line-inner{
            height: 100% !important;
        }
    }
</style>

clipboard.png

附上代码

import welcomeComponent from './../components/admin_base/welcome.vue';

//路由控制
let snavRouter = [
    {
        path: '/',
        redirect: '/index?pos=0'
    },
    {
        path: '/index',
        component: welcomeComponent
    }
];
export {snavRouter}

5.index.js和index.html

接下来就配置入口文件，和入口文件的模板了。
入口文件，index.js
clipboard.png
代码以下：

require("../../html/index.html");
import Vue from 'vue'
import VueRouter from 'vue-router'
import VueResource from 'vue-resource'
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-default/index.css'
//使用router
Vue.use(VueRouter);
//使用resource
Vue.use(VueResource);
//使用ElementUI
Vue.use(ElementUI);
//引入router配置
import {snavRouter} from './../router/router';
//实例化router
const router = new VueRouter({
    routes: snavRouter
});
/**
 * @description 启动App
 * @returns {{name: string}}
 * @constructor
 */
    //App启动
let App = new Vue({
    el: '#App',
    data(){
        return {
            'name': 'index'
        }
    },
    router: router,
    mounted(){
    },
});

入口文件模板，index.html

clipboard.png
代码以下

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=0.5, minimum-scale=0.5, maximum-scale=2.0">
    <title></title>
    <link rel="shortcut icon" href="/favicon.ico">
</head>
<body>
<div class="zyl-admin-wrap" id="App">
    <div class="zyl-admin-hd">
    </div>
    <div class="zyl-admin-bd">
        <div class="zyl-admin-snav">
        </div>
        <div class="zyl-admin-content">
            <div class="wrapper">
                <!-- 路由出口 -->
                <!-- 路由匹配到的组件将渲染在这里 -->
                <router-view></router-view>
            </div>
        </div>
    </div>
</div>
</body>
</html>

把改弄的都弄好了以后。先跑一下，证实一下本身的配置是否是正确的！，npm run dev

以前在package.json已经写好了，npm run dev
至关于执行dev对应的命令行，在命令行输入webpack-dev-server --hot --inline是同样的效果！

clipboard.png

在浏览器输入‘http://localhost:9090/dist/ht...’
运行结果成功的跑起来了！可是，你们有没有发现，在浏览器的地址栏，出现的是‘http://localhost:9090/dist/ht...’。结果是正常的，由于前面咱们配置了路由，而且使用了路由！至于在地址上后面我为何加上pos参数，下一章会说到！

clipboard.png

路由（vue-router）。大概原理就是，在浏览器地址栏输入‘http://localhost:9090/dist/ht...’，路由（vue-router）就匹配到了(path: '/')。而后，重定向到了(redirect: '/index?pos=0')，重定向又匹配到了(path: '/index')，而后就加载了组件，加载了这个组件(component: welcomeComponent)，就会在index.html的<router-view></router-view>里面输出这个组件的内容，（相关的知识，能够到网上参考vue-router）。这个组件(component: welcomeComponent)，就是咱们以前编写的welcome.vue。可能说的有点乱，你们注意整理下，理清思路。

clipboard.png

6.未完待遇

今天就先到这里了，这个系列日后会有几篇文章继续介绍，毕竟这篇文章只是介绍了基础的一个项目的搭建和配置。以及把项目跑起来！vue-router和element尚未写到。你们也放心好了，文章不会让你们等过久的。最后，若是你们发现我哪里写错了，或者是哪里写得很差，欢迎指点下。

联系我们 沪ICP备13005482号-10