这可能是vue-cli最全的解析了……

题言:

相信很多vue新手,都像我一样,只是知道可以用vue-cli直接生成一个vue项目的架构,并不明白,他究竟是怎么运行的,现在我们一起来研究一下。。。

一、安装vue-cli,相信你既然会用到vue-cli,自然node环境是OK的,直接命令行下安装

npm install -g vue-cli

二、使用vue-cli创建vue项目

用法: vue init <template-name> <project-name>
1 template-name:
2     . webpack
3     . webpack-simple  // 一个简单webpack+vue-loader的模板,不包含其他功能。
4     . browserify     //  一个全面的Browserify+vueify 的模板,功能包括热加载,linting,单元检测。
5     . browserify-simple  // 一个简单Browserify+vueify的模板,不包含其他功能。
6     . pwa           // 基于webpack模板的vue-cli的PWA模板
7     . simple      //  一个最简单的单页应用模板  

常用的就是webpack了,模板之间的不同,自己体验
示例:

vue init webpack my-project

执行指令后,会让用户输入几个基本的选项,如图所示

需要注意的是项目的名称不能大写,不然会报错。

  • Project name :项目名称 ,如果不需要更改直接回车就可以了。注意:这里不能使用大写。
  • Project description:项目描述,默认为A Vue.js project,直接回车,不用编写。
  • Author:作者,如果你有配置git,他会读取.ssh文件中的user。
  • Install vue-router? 是否安装vue的路由插件,Y代表安装,N无需安装,下面的命令也是一样的。
  • Use ESLint to lint your code? 是否用ESLint来限制你的代码错误和风格
  • setup unit tests with Karma + Mocha? 是否需要安装单元测试工具Karma+Mocha。
  • Setup e2e tests with Nightwatch?是否安装e2e来进行用户行为模拟测试。
  • Should we run npm install for you after the project has been created?(recommended)npm

    询问你使用npm安装还是yarn安装包依赖,我这里选择的是npm,yarn更快更好,使用yarn之前确保你的电脑已经安装yarn。

根据提示,待模板加载完成之后,执行下面两条命令

cd my-project

npm run dev   // dev代表下图框选的内容

出现如图,就是编译成功了,英文稍微好点,就能读懂 
这时候,鼠标放到 http://localhost:8080 会提示用“Alt+点击”即可访问;
出现如图,就成功创建了项目;

三、文件目录结构

本文主要分析开发(dev)和构建(build)两个过程涉及到的文件,故下面文件结构仅列出相应的内容。

|-- build                            // 项目构建(webpack)相关代码
|   |-- build.js                     // 生产环境构建代码
|   |-- check-version.js             // 检查node、npm等版本
|   |-- utils.js                     // 构建工具相关
|   |-- vue-loader.conf.js           // webpack loader配置
|   |-- webpack.base.conf.js         // webpack基础配置
|   |-- webpack.dev.conf.js          // webpack开发环境配置,构建开发本地服务器
|   |-- webpack.prod.conf.js         // webpack生产环境配置
|-- config                           // 项目开发环境配置
|   |-- dev.env.js                   // 开发环境变量
|   |-- index.js                     // 项目一些配置变量
|   |-- prod.env.js                  // 生产环境变量
|   |-- test.env.js                  // 测试脚本的配置
|-- src                              // 源码目录
|   |-- components                   // vue所有组件
|   |-- router                       // vue的路由管理
|   |-- App.vue                      // 页面入口文件
|   |-- main.js                      // 程序入口文件,加载各种公共组件
|-- static                           // 静态文件,比如一些图片,json数据等
|-- test                             // 测试文件
|   |-- e2e                          // e2e 测试
|   |-- unit                         // 单元测试
|-- .babelrc                         // ES6语法编译配置
|-- .editorconfig                    // 定义代码格式
|-- .eslintignore                    // eslint检测代码忽略的文件(夹)
|-- .eslintrc.js                     // 定义eslint的plugins,extends,rules
|-- .gitignore                       // git上传需要忽略的文件格式
|-- .postcsssrc                      // postcss配置文件
|-- README.md                        // 项目说明,markdown文档
|-- index.html                       // 访问的页面
|-- package.json                     // 项目基本信息,包依赖信息等

如图所示:

 
下边是具体文件的具体分析

1. package.json文件

package.json文件是项目的配置文件,定义了项目的基本信息以及项目的相关包依赖,npm运行命令等

scripts 里定义的是一些比较长的命令,用node去执行一段命令,比如

npm run dev

其实就是执行



webpack-dev-server --inline --progress --config build/webpack.dev.conf.js

这句话的意思是利用 webpack-dev-server 读取 webpack.dev.conf.js 信息并启动一个本地服务器。

2. dependencies VS devDependencies

简单的来说

dependencies 是运行时依赖(生产环境)       npm install --save  **(package name)
devDependencies 是开发时的依赖(开发环境)  npm install --save-dev  **(package name)

3. 基础配置文件 webpack.base.conf.js

基础的 webpack 配置文件主要根据模式定义了入口出口,以及处理 vue, babel等的各种模块,是最为基础的部分。其他模式的配置文件以此为基础通过 webpack-merge 合并。

  1 ‘use strict‘
  2 const path = require(‘path‘)
  3 const utils = require(‘./utils‘)
  4 const config = require(‘../config‘)
  5 const vueLoaderConfig = require(‘./vue-loader.conf‘)
  6
  7 // 获取绝对路径
  8 function resolve (dir) {
  9   return path.join(__dirname, ‘..‘, dir)
 10 }
 11 <!-- 定义一下代码检测的规则 -->
 12 const createLintingRule = () => ({
 13   test: /\.(js|vue)$/,
 14   loader: ‘eslint-loader‘,
 15   enforce: ‘pre‘,
 16   include: [resolve(‘src‘), resolve(‘test‘)],
 17   options: {
 18     formatter: require(‘eslint-friendly-formatter‘),
 19     emitWarning: !config.dev.showEslintErrorsInOverlay
 20   }
 21 })
 22
 23 module.exports = {
 24   // 基础上下文
 25   context: path.resolve(__dirname, ‘../‘),
 26   // webpack的入口文件
 27   entry: {
 28     app: ‘./src/main.js‘
 29   },
 30   // webpack的输出文件
 31   output: {
 32     path: config.build.assetsRoot,
 33     filename: ‘[name].js‘,
 34     publicPath: process.env.NODE_ENV === ‘production‘
 35       ? config.build.assetsPublicPath
 36       : config.dev.assetsPublicPath
 37   },
 38   /**
 39    * 当webpack试图去加载模块的时候,它默认是查找以 .js 结尾的文件的,
 40    * 它并不知道 .vue 结尾的文件是什么鬼玩意儿,
 41    * 所以我们要在配置文件中告诉webpack,
 42    * 遇到 .vue 结尾的也要去加载,
 43    * 添加 resolve 配置项,如下:
 44    */
 45   resolve: {
 46     extensions: [‘.js‘, ‘.vue‘, ‘.json‘],
 47     alias: {  // 创建别名
 48       ‘vue$‘: ‘vue/dist/vue.esm.js‘,
 49       ‘@‘: resolve(‘src‘),  // 如 ‘@/components/HelloWorld‘
 50     }
 51   },
 52   // 不同类型模块的处理规则 就是用不同的loader处理不同的文件
 53   module: {
 54     rules: [
 55       ...(config.dev.useEslint ? [createLintingRule()] : []),
 56       {// 对所有.vue文件使用vue-loader进行编译
 57         test: /\.vue$/,
 58         loader: ‘vue-loader‘,
 59         options: vueLoaderConfig
 60       },
 61       {// 对src和test文件夹下的.js文件使用babel-loader将es6+的代码转成es5
 62         test: /\.js$/,
 63         loader: ‘babel-loader‘,
 64         include: [resolve(‘src‘), resolve(‘test‘), resolve(‘node_modules/webpack-dev-server/client‘)]
 65       },
 66       {// 对图片资源文件使用url-loader
 67         test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
 68         loader: ‘url-loader‘,
 69         options: {
 70           // 小于10K的图片转成base64编码的dataURL字符串写到代码中
 71           limit: 10000,
 72           // 其他的图片转移到静态资源文件夹
 73           name: utils.assetsPath(‘img/[name].[hash:7].[ext]‘)
 74         }
 75       },
 76       {// 对多媒体资源文件使用url-loader
 77         test: /\.(mp4|webm|ogg|mp3|wav|flac|aac)(\?.*)?$/,
 78         loader: ‘url-loader‘,
 79         options: {
 80           // 小于10K的资源转成base64编码的dataURL字符串写到代码中
 81           limit: 10000,
 82           // 其他的资源转移到静态资源文件夹
 83           name: utils.assetsPath(‘media/[name].[hash:7].[ext]‘)
 84         }
 85       },
 86       {// 对字体资源文件使用url-loader
 87         test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
 88         loader: ‘url-loader‘,
 89         options: {
 90           limit: 10000,
 91           name: utils.assetsPath(‘fonts/[name].[hash:7].[ext]‘) // hash:7 代表 7 位数的 hash
 92         }
 93       }
 94     ]
 95   },
 96   node: {
 97     // prevent webpack from injecting useless setImmediate polyfill because Vue
 98     // source contains it (although only uses it if it‘s native).
 99     setImmediate: false,
100     // prevent webpack from injecting mocks to Node native modules
101     // that does not make sense for the client
102     dgram: ‘empty‘,
103     fs: ‘empty‘,
104     net: ‘empty‘,
105     tls: ‘empty‘,
106     child_process: ‘empty‘
107   }
108 }

4. 开发环境配置文件 webpack.dev.conf.js

  1 ‘use strict‘
  2 const utils = require(‘./utils‘)
  3 const webpack = require(‘webpack‘)
  4 const config = require(‘../config‘)  // 基本配置的参数
  5 const merge = require(‘webpack-merge‘) // webpack-merge是一个可以合并数组和对象的插件
  6 const path = require(‘path‘)
  7 const baseWebpackConfig = require(‘./webpack.base.conf‘) // webpack基本配置文件(开发和生产环境公用部分)
  8 const CopyWebpackPlugin = require(‘copy-webpack-plugin‘)
  9 // html-webpack-plugin用于将webpack编译打包后的产品文件注入到html模板中
 10 // 即在index.html里面加上<link>和<script>标签引用webpack打包后的文件
 11 const HtmlWebpackPlugin = require(‘html-webpack-plugin‘)
 12 // friendly-errors-webpack-plugin用于更友好地输出webpack的警告、错误等信息
 13 const FriendlyErrorsPlugin = require(‘friendly-errors-webpack-plugin‘)
 14 const portfinder = require(‘portfinder‘) // 自动检索下一个可用端口
 15
 16 const HOST = process.env.HOST
 17 const PORT = process.env.PORT && Number(process.env.PORT) ) // 读取系统环境变量的port
 18
 19 // 合并baseWebpackConfig配置
 20 const devWebpackConfig = merge(baseWebpackConfig, {
 21   module: {
 22     // 对一些独立的css文件以及它的预处理文件做一个编译
 23     rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap, usePostCSS: true })
 24   },
 25   // cheap-module-eval-source-map is faster for development
 26   devtool: config.dev.devtool,
 27
 28   // these devServer options should be customized in /config/index.js
 29   devServer: {  //  webpack-dev-server服务器配置
 30     clientLogLevel: ‘warning‘, // console 控制台显示的消息,可能的值有 none, error, warning 或者 info
 31     historyApiFallback: {
 32       rewrites: [
 33         { from: /.*/, to: path.posix.join(config.dev.assetsPublicPath, ‘index.html‘) },
 34       ],
 35     },
 36     hot: true, // 开启热模块加载
 37     contentBase: false, // since we use CopyWebpackPlugin.
 38     compress: true,
 39     host: HOST || config.dev.host, // process.env 优先
 40     port: PORT || config.dev.port, // process.env 优先
 41     open: config.dev.autoOpenBrowser,
 42     overlay: config.dev.errorOverlay
 43       ? { warnings: false, errors: true }
 44       : false,
 45     publicPath: config.dev.assetsPublicPath,
 46     proxy: config.dev.proxyTable, // 代理设置
 47     quiet: true, // necessary for FriendlyErrorsPlugin
 48     watchOptions: { // 启用 Watch 模式。这意味着在初始构建之后,webpack 将继续监听任何已解析文件的更改
 49       poll: config.dev.poll, // 通过传递 true 开启 polling,或者指定毫秒为单位进行轮询。默认为false
 50     }
 51   },
 52   plugins: [
 53     new webpack.DefinePlugin({
 54       ‘process.env‘: require(‘../config/dev.env‘)
 55     }),
 56     /*模块热替换它允许在运行时更新各种模块,而无需进行完全刷新*/
 57     new webpack.HotModuleReplacementPlugin(),
 58     new webpack.NamedModulesPlugin(), // HMR shows correct file names in console on update.
 59     new webpack.NoEmitOnErrorsPlugin(),// 跳过编译时出错的代码并记录下来,主要作用是使编译后运行时的包不出错
 60     // https://github.com/ampedandwired/html-webpack-plugin
 61     new HtmlWebpackPlugin({
 62     // 指定编译后生成的html文件名
 63       filename: ‘index.html‘,
 64       // 需要处理的模板
 65       template: ‘index.html‘,
 66       // 打包过程中输出的js、css的路径添加到html文件中
 67       // css文件插入到head中
 68       // js文件插入到body中,可能的选项有 true, ‘head‘, ‘body‘, false
 69       inject: true
 70     }),
 71     // copy custom static assets
 72     new CopyWebpackPlugin([
 73       {
 74         from: path.resolve(__dirname, ‘../static‘),
 75         to: config.dev.assetsSubDirectory,
 76         ignore: [‘.*‘]
 77       }
 78     ])
 79   ]
 80 })
 81
 82 module.exports = new Promise((resolve, reject) => {
 83   portfinder.basePort = process.env.PORT || config.dev.port // 获取当前设定的端口
 84   portfinder.getPort((err, port) => {
 85     if (err) {
 86       reject(err)
 87     } else {
 88       // publish the new Port, necessary for e2e tests   发布新的端口,对于e2e测试
 89       process.env.PORT = port
 90       // add port to devServer config
 91       devWebpackConfig.devServer.port = port
 92
 93       // Add FriendlyErrorsPlugin
 94       devWebpackConfig.plugins.push(new FriendlyErrorsPlugin({
 95         compilationSuccessInfo: {
 96           messages: [`Your application is running here: http://${devWebpackConfig.devServer.host}:${port}`],
 97         },
 98         onErrors: config.dev.notifyOnErrors
 99         ? utils.createNotifierCallback()
100         : undefined
101       }))
102
103       resolve(devWebpackConfig)
104     }
105   })
106 })

5. 生产模式配置文件 webpack.prod.conf.js

  1 ‘use strict‘
  2 const path = require(‘path‘)
  3 const utils = require(‘./utils‘)
  4 const webpack = require(‘webpack‘)
  5 const config = require(‘../config‘)
  6 const merge = require(‘webpack-merge‘)
  7 const baseWebpackConfig = require(‘./webpack.base.conf‘)
  8 // copy-webpack-plugin,用于将static中的静态文件复制到产品文件夹dist
  9 const CopyWebpackPlugin = require(‘copy-webpack-plugin‘)
 10 const HtmlWebpackPlugin = require(‘html-webpack-plugin‘)
 11 const ExtractTextPlugin = require(‘extract-text-webpack-plugin‘)
 12 // optimize-css-assets-webpack-plugin,用于优化和最小化css资源
 13 const OptimizeCSSPlugin = require(‘optimize-css-assets-webpack-plugin‘)
 14 // uglifyJs 混淆js插件
 15 const UglifyJsPlugin = require(‘uglifyjs-webpack-plugin‘)
 16
 17 const env = process.env.NODE_ENV === ‘testing‘
 18   ? require(‘../config/test.env‘)
 19   : require(‘../config/prod.env‘)
 20
 21 const webpackConfig = merge(baseWebpackConfig, {
 22   module: {
 23     // 样式文件的处理规则,对css/sass/scss等不同内容使用相应的styleLoaders
 24     // 由utils配置出各种类型的预处理语言所需要使用的loader,例如sass需要使用sass-loader
 25     rules: utils.styleLoaders({
 26       sourceMap: config.build.productionSourceMap,
 27       extract: true,
 28       usePostCSS: true
 29     })
 30   },
 31   devtool: config.build.productionSourceMap ? config.build.devtool : false,
 32   // webpack输出路径和命名规则
 33   output: {
 34     path: config.build.assetsRoot,
 35     filename: utils.assetsPath(‘js/[name].[chunkhash].js‘),
 36     chunkFilename: utils.assetsPath(‘js/[id].[chunkhash].js‘)
 37   },
 38   plugins: [
 39     // http://vuejs.github.io/vue-loader/en/workflow/production.html
 40     new webpack.DefinePlugin({
 41       ‘process.env‘: env
 42     }),
 43     // 丑化压缩JS代码
 44     new UglifyJsPlugin({
 45       uglifyOptions: {
 46         compress: {
 47           warnings: false
 48         }
 49       },
 50       sourceMap: config.build.productionSourceMap,
 51       parallel: true
 52     }),
 53     // extract css into its own file
 54     // 将css提取到单独的文件
 55     new ExtractTextPlugin({
 56       filename: utils.assetsPath(‘css/[name].[contenthash].css‘),
 57       // Setting the following option to `false` will not extract CSS from codesplit chunks.
 58       // Their CSS will instead be inserted dynamically with style-loader when the codesplit chunk has been loaded by webpack.
 59       // It‘s currently set to `true` because we are seeing that sourcemaps are included in the codesplit bundle as well when it‘s `false`,
 60       // increasing file size: https://github.com/vuejs-templates/webpack/issues/1110
 61       allChunks: true,
 62     }),
 63     // Compress extracted CSS. We are using this plugin so that possible
 64     // duplicated CSS from different components can be deduped.
 65     // 优化、最小化css代码,如果只简单使用extract-text-plugin可能会造成css重复
 66     // 具体原因可以看npm上面optimize-css-assets-webpack-plugin的介绍
 67     new OptimizeCSSPlugin({
 68       cssProcessorOptions: config.build.productionSourceMap
 69         ? { safe: true, map: { inline: false } }
 70         : { safe: true }
 71     }),
 72     // generate dist index.html with correct asset hash for caching.
 73     // you can customize output by editing /index.html
 74     // see https://github.com/ampedandwired/html-webpack-plugin
 75     // 将产品文件的引用注入到index.html
 76     new HtmlWebpackPlugin({
 77       filename: process.env.NODE_ENV === ‘testing‘
 78         ? ‘index.html‘
 79         : config.build.index,
 80       template: ‘index.html‘,
 81       inject: true,
 82       minify: {
 83         // 删除index.html中的注释
 84         removeComments: true,
 85         // 删除index.html中的空格
 86         collapseWhitespace: true,
 87         // 删除各种html标签属性值的双引号
 88         removeAttributeQuotes: true
 89         // more options:
 90         // https://github.com/kangax/html-minifier#options-quick-reference
 91       },
 92       // necessary to consistently work with multiple chunks via CommonsChunkPlugin
 93       // 注入依赖的时候按照依赖先后顺序进行注入,比如,需要先注入vendor.js,再注入app.js
 94       chunksSortMode: ‘dependency‘
 95     }),
 96     // keep module.id stable when vendor modules does not change
 97     new webpack.HashedModuleIdsPlugin(),
 98     // enable scope hoisting
 99     new webpack.optimize.ModuleConcatenationPlugin(),
100     // split vendor js into its own file
101     // 将所有从node_modules中引入的js提取到vendor.js,即抽取库文件
102     new webpack.optimize.CommonsChunkPlugin({
103       name: ‘vendor‘,
104       minChunks (module) {
105         // any required modules inside node_modules are extracted to vendor
106         return (
107           module.resource &&
108           /\.js$/.test(module.resource) &&
109           module.resource.indexOf(
110             path.join(__dirname, ‘../node_modules‘)
111           ) === 0
112         )
113       }
114     }),
115     // extract webpack runtime and module manifest to its own file in order to
116     // prevent vendor hash from being updated whenever app bundle is updated
117     // 从vendor中提取出manifest,原因如上
118     new webpack.optimize.CommonsChunkPlugin({
119       name: ‘manifest‘,
120       minChunks: Infinity
121     }),
122     // This instance extracts shared chunks from code splitted chunks and bundles them
123     // in a separate chunk, similar to the vendor chunk
124     // see: https://webpack.js.org/plugins/commons-chunk-plugin/#extra-async-commons-chunk
125     new webpack.optimize.CommonsChunkPlugin({
126       name: ‘app‘,
127       async: ‘vendor-async‘,
128       children: true,
129       minChunks: 3
130     }),
131
132     // copy custom static assets
133     // 将static文件夹里面的静态资源复制到dist/static
134     new CopyWebpackPlugin([
135       {
136         from: path.resolve(__dirname, ‘../static‘),
137         to: config.build.assetsSubDirectory,
138         ignore: [‘.*‘]
139       }
140     ])
141   ]
142 })
143
144 // 如果开启了产品gzip压缩,则利用插件将构建后的产品文件进行压缩
145 if (config.build.productionGzip) {
146   // 一个用于压缩的webpack插件
147   const CompressionWebpackPlugin = require(‘compression-webpack-plugin‘)
148
149   webpackConfig.plugins.push(
150     new CompressionWebpackPlugin({
151       asset: ‘[path].gz[query]‘,
152       // 压缩算法
153       algorithm: ‘gzip‘,
154       test: new RegExp(
155         ‘\\.(‘ +
156         config.build.productionGzipExtensions.join(‘|‘) +
157         ‘)$‘
158       ),
159       threshold: 10240,
160       minRatio: 0.8
161     })
162   )
163 }
164
165 // 如果启动了report,则通过插件给出webpack构建打包后的产品文件分析报告
166 if (config.build.bundleAnalyzerReport) {
167   const BundleAnalyzerPlugin = require(‘webpack-bundle-analyzer‘).BundleAnalyzerPlugin
168   webpackConfig.plugins.push(new BundleAnalyzerPlugin())
169 }
170
171 module.exports = webpackConfig

6. build.js 编译入口

 1 ‘use strict‘
 2 require(‘./check-versions‘)()
 3
 4 process.env.NODE_ENV = ‘production‘
 5 // ora,一个可以在终端显示spinner的插件
 6 const ora = require(‘ora‘)
 7 // rm,用于删除文件或文件夹的插件
 8 const rm = require(‘rimraf‘)
 9 const path = require(‘path‘)
10 // chalk,用于在控制台输出带颜色字体的插件
11 const chalk = require(‘chalk‘)
12 const webpack = require(‘webpack‘)
13 const config = require(‘../config‘)
14 const webpackConfig = require(‘./webpack.prod.conf‘)
15
16 const spinner = ora(‘building for production...‘)
17 spinner.start() // 开启loading动画
18
19 // 首先将整个dist文件夹以及里面的内容删除,以免遗留旧的没用的文件
20 // 删除完成后才开始webpack构建打包
21 rm(path.join(config.build.assetsRoot, config.build.assetsSubDirectory), err => {
22   if (err) throw err
23   // 执行webpack构建打包,完成之后在终端输出构建完成的相关信息或者输出报错信息并退出程序
24   webpack(webpackConfig, (err, stats) => {
25     spinner.stop()
26     if (err) throw err
27     process.stdout.write(stats.toString({
28       colors: true,
29       modules: false,
30       children: false, // If you are using ts-loader, setting this to true will make TypeScript errors show up during build.
31       chunks: false,
32       chunkModules: false
33     }) + ‘\n\n‘)
34
35     if (stats.hasErrors()) {
36       console.log(chalk.red(‘  Build failed with errors.\n‘))
37       process.exit(1)
38     }
39
40     console.log(chalk.cyan(‘  Build complete.\n‘))
41     console.log(chalk.yellow(
42       ‘  Tip: built files are meant to be served over an HTTP server.\n‘ +
43       ‘  Opening index.html over file:// won\‘t work.\n‘
44     ))
45   })
46 })

7. 实用代码段 utils.js

  1 ‘use strict‘
  2 const path = require(‘path‘)
  3 const config = require(‘../config‘)
  4 // extract-text-webpack-plugin可以提取bundle中的特定文本,将提取后的文本单独存放到另外的文件
  5 // 这里用来提取css样式
  6 const ExtractTextPlugin = require(‘extract-text-webpack-plugin‘)
  7 const packageConfig = require(‘../package.json‘)
  8
  9 // 资源文件的存放路径
 10 exports.assetsPath = function (_path) {
 11   const assetsSubDirectory = process.env.NODE_ENV === ‘production‘
 12     ? config.build.assetsSubDirectory
 13     : config.dev.assetsSubDirectory
 14
 15   return path.posix.join(assetsSubDirectory, _path)
 16 }
 17
 18 // 生成css、sass、scss等各种用来编写样式的语言所对应的loader配置
 19 exports.cssLoaders = function (options) {
 20   options = options || {}
 21   // css-loader配置
 22   const cssLoader = {
 23     loader: ‘css-loader‘,
 24     options: {
 25       // 是否使用source-map
 26       sourceMap: options.sourceMap
 27     }
 28   }
 29
 30   const postcssLoader = {
 31     loader: ‘postcss-loader‘,
 32     options: {
 33       sourceMap: options.sourceMap
 34     }
 35   }
 36
 37   // generate loader string to be used with extract text plugin
 38   // 生成各种loader配置,并且配置了extract-text-pulgin
 39   function generateLoaders (loader, loaderOptions) {
 40     const loaders = options.usePostCSS ? [cssLoader, postcssLoader] : [cssLoader]
 41     // 例如generateLoaders(‘less‘),这里就会push一个less-loader
 42     // less-loader先将less编译成css,然后再由css-loader去处理css
 43     // 其他sass、scss等语言也是一样的过程
 44     if (loader) {
 45       loaders.push({
 46         loader: loader + ‘-loader‘,
 47         options: Object.assign({}, loaderOptions, {
 48           sourceMap: options.sourceMap
 49         })
 50       })
 51     }
 52
 53     // Extract CSS when that option is specified
 54     // (which is the case during production build)
 55     if (options.extract) {
 56       // 配置extract-text-plugin提取样式
 57       return ExtractTextPlugin.extract({
 58         use: loaders,
 59         fallback: ‘vue-style-loader‘
 60       })
 61     } else {
 62        // 无需提取样式则简单使用vue-style-loader配合各种样式loader去处理<style>里面的样式
 63       return [‘vue-style-loader‘].concat(loaders)
 64     }
 65   }
 66
 67   // https://vue-loader.vuejs.org/en/configurations/extract-css.html
 68   // 得到各种不同处理样式的语言所对应的loader
 69   return {
 70     css: generateLoaders(),
 71     postcss: generateLoaders(),
 72     less: generateLoaders(‘less‘),
 73     sass: generateLoaders(‘sass‘, { indentedSyntax: true }),
 74     scss: generateLoaders(‘sass‘),
 75     stylus: generateLoaders(‘stylus‘),
 76     styl: generateLoaders(‘stylus‘)
 77   }
 78 }
 79
 80 // Generate loaders for standalone style files (outside of .vue)
 81 // 生成处理单独的.css、.sass、.scss等样式文件的规则
 82 exports.styleLoaders = function (options) {
 83   const output = []
 84   const loaders = exports.cssLoaders(options)
 85
 86   for (const extension in loaders) {
 87     const loader = loaders[extension]
 88     output.push({
 89       test: new RegExp(‘\\.‘ + extension + ‘$‘),
 90       use: loader
 91     })
 92   }
 93
 94   return output
 95 }
 96
 97 exports.createNotifierCallback = () => {
 98   const notifier = require(‘node-notifier‘)
 99
100   return (severity, errors) => {
101     if (severity !== ‘error‘) return
102
103     const error = errors[0]
104     const filename = error.file && error.file.split(‘!‘).pop()
105
106     notifier.notify({
107       title: packageConfig.name,
108       message: severity + ‘: ‘ + error.name,
109       subtitle: filename || ‘‘,
110       icon: path.join(__dirname, ‘logo.png‘)
111     })
112   }
113 }

8. babel配置文件.babelrc

 1 { //设定转码规则
 2   "presets": [
 3     ["env", {
 4       "modules": false,
 5       //对BABEL_ENV或者NODE_ENV指定的不同的环境变量,进行不同的编译操作
 6       "targets": {
 7         "browsers": ["> 1%", "last 2 versions", "not ie <= 8"]
 8       }
 9     }],
10     "stage-2"
11   ],
12   //转码用的插件
13   "plugins": ["transform-vue-jsx", "transform-runtime"]
14 }

9 .编码规范.editorconfig (自定义)

1 root = true
2
3 [*]    // 对所有文件应用下面的规则
4 charset = utf-8                    // 编码规则用utf-8
5 indent_style = space               // 缩进用空格
6 indent_size = 2                    // 缩进数量为2个空格
7 end_of_line = lf                   // 换行符格式
8 insert_final_newline = true        // 是否在文件的最后插入一个空行
9 trim_trailing_whitespace = true    // 是否删除行尾的空格

10 .src/app.vue文件解读

 1 <template>
 2   <div id="app">
 3     <img src="./assets/logo.png">
 4     <router-view></router-view>
 5   </div>
 6 </template>
 7
 8 <script>
 9 export default {
10   name: ‘app‘
11 }
12 </script>
13
14 <style>
15 #app {
16   font-family: ‘Avenir‘, Helvetica, Arial, sans-serif;
17   -webkit-font-smoothing: antialiased;
18   -moz-osx-font-smoothing: grayscale;
19   text-align: center;
20   color: #2c3e50;
21   margin-top: 60px;
22 }
23 </style>
<template></template> 标签包裹的内容:这是模板的HTMLDom结构
<script></script>     标签包括的js内容:你可以在这里写一些页面的js的逻辑代码。
<style></style>       标签包裹的css内容:页面需要的CSS样式。

11. src/router/index.js 路由文件

 1 import Vue from ‘vue‘
 2 import Router from ‘vue-router‘
 3 import Hello from ‘@/components/Hello‘
 4
 5 Vue.use(Router)
 6
 7 export default new Router({
 8   routes: [//配置路由
 9     {
10       path: ‘/‘,        //访问路径
11       name: ‘Hello‘,    //路由名称
12       component: Hello  //路由需要的组件(驼峰式命名)
13     }
14   ]

12. eslint的相关配置(按照AirBnb的规则检测);

原文地址:https://www.cnblogs.com/zhaowy/p/9542369.html

时间: 2024-10-07 11:28:42

这可能是vue-cli最全的解析了……的相关文章

使用@vue/cli初始化项目

Vue CLI 的包名称由 vue-cli 改成了 @vue/cli. 如果你已经全局安装了旧版本的 vue-cli (1.x 或 2.x),你需要先通过 npm uninstall vue-cli -g 卸载它.附上vue-cli官方文档地址 首先检查你的node版本,Vue CLI 需要 Node.js 8.9 或更高版本 (推荐 8.11.0+),命令为 node --version 1.安装vue-cli,-g表示全局安装,这样你才可以直接在命令行使用该指令,否则不行 npm insta

Vue CLI 3.x搭建Vue项目

一.Node安装 windows 1. Node.js (>=8.9, 推荐8.11.0+) Node官网下载 .msi 文件,按步骤下载安装即可. 安装完之后在cmd中输入 node -v,若显示版本号,则说明安装成功. 2. Git(命令行终端) Git官网下载安装即可. Linux apt-get install nodejs node -v apt-get install npm npm -v npm命令1.得到原本的镜像地址 npm get registry 2.设置成淘宝 npm c

Vue CLI 3搭建vue+vuex 最全分析

一.介绍 Vue CLI 是一个基于 Vue.js 进行快速开发的完整系统.有三个组件: CLI:@vue/cli 全局安装的 npm 包,提供了终端里的vue命令(如:vue create .vue serve .vue ui 等命令) CLI 服务:@vue/cli-service是一个开发环境依赖.构建于 webpack 和 webpack-dev-server 之上(提供 如:serve.build 和 inspect 命令) CLI 插件:给Vue 项目提供可选功能的 npm 包 (如

用Vue实现一个全选指令

最近用vue做了两个项目,都需要实现全选反选的功能,两个项目用了两种实现方法,第一个项目用vue的computed,第二个项目用指令来实现,用起来,发觉指令更加方便. 第一次做全选的时候是刚开始接触vue不久,全选的实现参考了知乎(链接:https://www.zhihu.com/question/37833194/answer/91812053)上的实现方法:1.从服务器拿到数据,为每个item设置checked属性2.计算选中的数量selectCount,如果选中的数量与selectItem

使用vue cli开发项目中遇到的坑

一.部署文件 使用vue cli 开发项目,执行npm run build命令生成dist静态文件,将dist文件包放到服务器中即可. 刚接触webpack,不知道怎么部署前端文件,原以为需要将app文件上传,在 inux上安装node,以及npm install 一系列的包,捣鼓了很久,发现只需要执行 npm run build 将源码打包成一个静态文        文件即可,上传静态文件dist,将 controller指向index.html. 二.跨域问题 实行前后端分离,使用vue i

实习模块vue+java小型全栈开发(三)

实习模块vue+java小型全栈开发(三) --dx 背景 首先,先给自己一个答案:这篇博客我定义为(三),因为之前的两个模块页面,内容都是一样的,但是被改了几次需求,就一直拖着没有上传. 今天是真正意义上的全栈开发,用的都是当前市面上的最新的框架前端是vuejs,后端springBoot全家桶,知识点很全,而我正好勉强的把前端知识赶完,然后进行的这次模块开发,并且这次模块开发给了我很大的惊喜. 全栈果然很神奇. 模块简介:点击考勤之后,调到一个页面,完成这个页面的所用功能. 完成之后的页面:我

如何使用@vue/cli 3.0在npm上创建,发布和使用你自己的Vue.js组件库

译者按: 你可能npm人家的包过成千上万次,但你是否有创建,发布和使用过自己的npm包? 原文: How to create, publish and use your own VueJS Component library on NPM using @vue/cli 3.0 译者: Fundebug 为了保证可读性,本文采用意译而非直译.另外,本文版权归原作者所有,翻译仅用于学习. 尽管我已经在工作上用了Vue.js一段时间,但我从不需要在npm上发布组件.但最近发现在不同的项目重写组件是件非

vue.cli脚手架初次使用图文教程

vue.cli脚手架初次使用图文教程 我之前的环境是安装了node.js, 我记得曾经好像安装过vue ,不过现在又要重新开始学习起来了.在youtube上看了一vue的相关教程,还是需要实操的. 好像安装过npm -v 发现已经安装了5.6.0 需要安装然后使用 cnpm 安装 vue-cli 和 webpack 安装代码:npm install -g vue-cli 一.生成项目 首先需要在命令行中进入到项目目录,然后输入: vue init webpack vue-testone p.p1

Vue CLI 3开发中屏蔽烦人的EsLint错误

问题 Vue开发中,特别是当你阅读分析别人的其中早期版本的Vue代码时往往会遭遇到满屏幕的烦人的EsLint错误.有关EsLint这个工具的作用不再赘述.查阅网上参考文档,大多是针对早起版本Vue CLI工具项目的,在我最新使用的Vue CLI 3生成的工程中根本不起作用.无奈之下,认真学习了Vue CLI 3官方文档,终于找到最佳答案. 办法 Vue这个前端框架相对于React和Angular,入门会非常快.但是,到了中后期实战阶段仍然有许多工程实际问题需要我们一块一块地攻克.Vue CLI这

Vue CLI 3开发中试用UIkit 3组件库

一.UIkit组件库与vuikit简介 在选择好意中的前端开发基本框架后,接下来一个重要任务就是选择一款好的UI组件库.其中,UIkit组件库是一款基于Less+JS的一款轻量级.模块化.响应式的前端UI组件库.特别是,从版本3.0.0 beta 31开始完全脱离了jQuery框架.UIkit组件库的一个重要特点是,其提供的组件大部分是非常基础性的,但是也有一部分组件相当实用,例如Slideshow组件.Upload组件.Video组件等,在github网站上的评价星数是13K,相当不错.另一个