背景
以前的项目要不是前人搭建的,要不就是从 vue-cli 搭建,然后将一些旧项目公用的代码搬过来,这些操作下来一个小时估计是跑不了的了,所以搭建属于自己的 template 是一件省时省力的事情。
本文章不会讲到 vue-cli 的原理和实现,有兴趣的同学可以阅读 从vue-cli源码学习如何写模板,这篇文章写的很好,足够理解 vue-cli 的原理了。
如何修改 template 文件
首先,需要从 template/webpack 下载官方 template/webpack 项目,我们主要修改的地方是根目录下的meta.js
文件和template
目录;
meta.js:
主要改两个地方:prompts 和 filters,我们用过 prompts 库的都知道,这是一个命令行的问答工具,在使用vue init webpack my-project
这个命令的使用,需要回答一些问题,就是依赖于 prompts 这个库;
// prompts(节选)
prompts: {
name: {
when: 'isNotTest', // 代表不是test的时候询问(isNotTest可以看scenarios/index.js文件)
type: 'string', // 问题的类型,这里 string 代表输入项目名字
required: true, // 必须填写 name
message: 'Project name', // 问题的描述
},
lint: {
when: 'isNotTest',
type: 'confirm',
message: 'Use ESLint to lint your code?',
},
lintConfig: {
when: 'isNotTest && lint', // 代表不是test并且上面lint问题选择yes才询问
type: 'list', // 答案从choices中选择
message: 'Pick an ESLint preset',
choices: [
{
name: 'Standard (https://github.com/standard/standard)',
value: 'standard',
short: 'Standard',
},
{
name: 'Airbnb (https://github.com/airbnb/javascript)',
value: 'airbnb',
short: 'Airbnb',
},
{
name: 'none (configure it yourself)',
value: 'none',
short: 'none',
}
],
}
}
// filters(节选)
filters: {
'.eslintrc.js': 'lint', // .eslintrc.js文件只有lint问题选择yes才会创建
'build/webpack.test.conf.js': "unit && runner === 'karma'", // webpack.test.conf.js文件只有unit问题选择yes并且runner问题选择karma选项才会创建
'src/router/**/*': 'router' // src/router目录只有在router问题选择yes才会创建
}
template:
- 编写EOF条件
可以看到template文件夹看起来就是一个
vue init
命令后的目录了,但仔细看文件的话可以看到差异:
// package.json/scripts
"scripts": {
"dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
"start": "npm run dev",
{{#if_eq runner "jest"}}
"unit": "jest --config test/unit/jest.conf.js --coverage",
{{/if_eq}}
{{#if_eq runner "karma"}}
"unit": "cross-env BABEL_ENV=test karma start test/unit/karma.conf.js --single-run",
{{/if_eq}}
{{#e2e}}
"e2e": "node test/e2e/runner.js",
{{/e2e}}
{{#if_or unit e2e}}
"test": "{{#unit}}npm run unit{{/unit}}{{#unit}}{{#e2e}} && {{/e2e}}{{/unit}}{{#e2e}}npm run e2e{{/e2e}}",
{{/if_or}}
{{#lint}}
"lint": "eslint --ext .js,.vue src{{#unit}} test/unit{{/unit}}{{#e2e}} test/e2e/specs{{/e2e}}",
{{/lint}}
"build": "node build/build.js"
}
可以看多在package.json文件里穿插着一些EOF风格的标签,这些标签可分为两种(可以自己扩展EOF条件)
{{#lint}}***{{/lint}}
表示标签内的内容只有在lint问题选择yes才会存在
{{#if_eq runner "jest"}}***{{/if_eq}}
表示标签内的内容只有在runner
问题的答案等于jest
的情况才会存在,个人可以扩展EOF的条件命令(在lib/generate.js
, 默认有if_eq
和unless_eq
两个命令)
- 修改文件目录
这个直接将template的目录结构改变即可,这里把src目录改成自己习惯的目录结构
我自己的template
github:masongzhi/vue-template-webpack
用法:vue init masongzhi/vue-template-webpack my-project
vue-template-webpack 特点:
- 基于 template/webpack 模板
- 自定义目录结构
- 增加 vuex 选项
- 增加 filters 选项
- 增加 mock 服务器选项
- 增加 prettier 选项(不选择 lint 情况下,lint 情况请自行添加)
总结
其实我发觉再不介绍原理的情况下,感觉写的挺乱的,所以建议大家可以先阅读 从vue-cli源码学习如何写模板,再看本文章进行实践;
创建好自己的template模板后,之后再搭建新项目就不用手动的复制黏贴了,确实是很方便的。