重度代码洁癖患者该如何用vscode开发Vue应用?

论坛 期权论坛 期权     
前端开发   2019-6-8 05:30   2283   0
来自:SegmentFault,作者:张京
链接:https://segmentfault.com/a/1190000019055976
现在用VSCode开发Vue.js应用几乎已经是前端的标配了,但很多时候我们看到的代码混乱不堪,作为一个前端工程师,单引号双引号乱用,一段有分号一段没有分号,有的地方有逗号有的地方没有逗号,空格回车都对不齐,还说自己做事认真,这不是开玩笑的事情。
我们今天从头开始,完整地讲述一下一个重度代码洁癖患者该如何用
  1. vscode
复制代码
开发
  1. vue
复制代码
,以及如何把一个已经可以宣判死刑的全身各种格式错误几万条的项目整容成标准美女。[h2]从安装开始[/h2]为了准确起见,我们把
  1. vscode
复制代码
里所有插件全部禁用,把用户设置清空,以让它尽可能恢复成原始的样子:


作为代码洁癖患者,对于系统的版本要求一定也是最苛刻的,不管什么时候,都让我们把所有的系统能升级的都升级到最高版本:
  1. npm install -g @vue/cli
复制代码
然后,我们开始创建项目:
  1. vue create hello-world
复制代码
在这里,一定要选择第一项:
  1. babel + eslint
复制代码
,这两个是必不可少的。我见到有些人嫌
  1. eslint
复制代码
麻烦,居然在项目建立好之后手工把
  1. eslint
复制代码
关掉的,简直无语。


安装完毕:


我们先不急着执行,执行代码是最容易的事情,我们先打开代码看一下:

好吧,至少我们需要先安装vetur插件。这几乎已经确定是开发
  1. vue
复制代码
项目的标配了,即使我不说,
  1. vscode
复制代码
也会强烈建议你安装它。


装上
  1. vetur
复制代码
以后多少有点人样了。接下来我们来试一试能不能自动格式化,这部分才是洁癖患者的最爱。胡乱加几个空格,然后保存试试看:


不能格式化,连个提示都没有!
[h2]用lint格式化[/h2]就算
  1. vscode
复制代码
里的
  1. vetur
复制代码
不能帮我们自动格式化,好在
  1. package.json
复制代码
命令里还有一个
  1. lint
复制代码
命令,我们看看
  1. lint
复制代码
命令能不能帮我们自动格式化:

  1. lint
复制代码
居然说没有错误!明明就是多了很多空格的错误好吧,为什么?

这是因为缺省的
  1. vue-cli
复制代码
没有为我们安装
  1. @vue/prettier
复制代码
插件,我们先来手工安装一下:
  1. yarn add -D @vue/eslint-config-prettier
复制代码
然后在
  1. package.json
复制代码
或者
  1. .eslintrc.js
复制代码
或者其它什么你设置
  1. eslint
复制代码
的地方,给它加上:
  1.     "extends": [
  2.       "plugin:vue/essential",
  3.       "eslint:recommended",
  4.       "@vue/prettier"
  5.     ],
复制代码

特别是最后这一个
  1. @vue/prettier
复制代码
,非常重要。然后再执行
  1. yarn lint
复制代码
。多余的空格被自动干掉了,但是我们发现有一些地方同时也被篡改了:


所有的单引号被变成双引号了,原本行尾没有的分号被加上了分号。这是为什么呢?因为我们虽然引入了
  1. prettier
复制代码
,但是还没有对
  1. prettier
复制代码
做设置,我们在项目的根目录下创建一个
  1. .prettierrc.js
复制代码
文件,然后在其中加入:
  1. module.exports = {
  2.   semi: false,
  3.   singleQuote: true
  4. }
复制代码
再次执行
  1. yarn lint
复制代码
,现在我们看到
  1. lint
复制代码
已经能够起作用了。它不但能把我们多余插入的空格删掉,并且能按照规则把双引号变成单引号,把行尾多余的分号删掉。当然,关于行尾加不加分号这是一个哲学命题,你可以根据你个人的喜好自行决定。在这里,我们权且按照vue-cli的标配执行。


到这一步很关键,假设你拿到一个烂的不再烂的
  1. vue
复制代码
项目,里面有几千个
  1. .vue
复制代码
文件,几万个各种格式错误,也都能通过
  1. yarn lint
复制代码
这一行命令把它们全部修正过来!
[h2]在vscode里格式化[/h2]事情还没有完,我们注意到虽然
  1. yarn lint
复制代码
命令能在编写完代码之后帮我们格式化,但是既然我们是用
  1. vscode
复制代码
进行开发,我们当然希望能在
  1. vscode
复制代码
里直接看到对于错误的标注。

这时候我们需要在
  1. vscode
复制代码
里再安装一个插件eslint。

你以为安装上
  1. eslint
复制代码
插件就行了吗?不行的。因为
  1. eslint
复制代码
并不知道我们的
  1. .vue
复制代码
文件里面包含了
  1. js
复制代码
语法,所以还需要打开我们的
  1. vscode
复制代码
设置文件。
注意:这里一定要设置到项目的设置里,而不要只是设置到你自己个人的设置里,否则你团队的小伙伴随便一改又乱掉了。正确的方法是在你项目的文件夹下有一个
  1. .vscode
复制代码
文件夹,而
  1. vue
复制代码
最讨厌的地方是它居然会把这个文件夹放到
  1. .gitignore
复制代码
里,这个错误你必须要纠正过来,也就是说从
  1. .gitignore
复制代码
文件里把
  1. .vscode
复制代码
删掉。切切。
在你项目的
  1. settings.json
复制代码
里文件里添加以下代码:
  1. {
  2.   "eslint.autoFixOnSave": true,
  3.   "eslint.validate": [
  4.     "javascript",
  5.     "javascriptreact",
  6.     {
  7.       "language": "vue",
  8.       "autoFix": true
  9.     }
  10.   ],
  11. }
复制代码
这时候所有错误都被标注出来了,注意看左侧,一定要让这个
  1. settings.json
复制代码
文件是绿色的,而不能是灰色的,如果是灰色的,请检查你的
  1. .gitignore
复制代码
文件:


因为我们在
  1. settings.json
复制代码
文件里设置了
  1. autoFixOnSave
复制代码
,所以不管多么乱的格式,只要一按
  1. Ctrl+S
复制代码
保存,自动就帮我们把代码格式整理好了,是不是很方便呢?
[h2]和Prettier的冲突[/h2]有些时候我们的
  1. vscode
复制代码
里插件装的比较多,譬如还安装了prettier插件,因为我们不只开发
  1. vue
复制代码
项目,可能还有其它类型的
  1. js
复制代码
项目特别是传统
  1. js
复制代码
项目,需要用到
  1. prettier
复制代码
进行美化,而
  1. prettier
复制代码
的一些功能是会和
  1. eslint
复制代码
相冲突的,比如说我们在全局设置了
  1. prettier
复制代码
  1. formatOnSave
复制代码
,这个功能就会和
  1. eslint
复制代码
  1. autoFixOnSave
复制代码
打架,为了避免这个矛盾,我们通常还会在本项目的
  1. settings.json
复制代码
文件里再多加几个选项,类似于这样:
  1.   "editor.tabSize": 2,
  2.   "editor.formatOnSave": false,
  3.   "prettier.semi": false,
  4.   "prettier.singleQuote": true
复制代码
有了这些设置,基本上
  1. prettier
复制代码
就不会和
  1. eslint
复制代码
打架了。
[h2]小结[/h2]以上就是用
  1. vscode
复制代码
开发
  1. vue
复制代码
程序的标配,并不像网上有些文章说的那么简单,不是只需要配一个
  1. eslint
复制代码
就能解决的事情,这里还用到了
  1. vetur
复制代码
  1. eslint
复制代码
  1. prettier
复制代码
,把几个工具综合用好,才能真正达到我们的错误随时可见,保存自动修改,更正既往错误的目的。希望每个前端工程师写出的代码都如出一人之手,漂亮简洁干净。
我们的目标始终如一:
  1. 0错误0警告
复制代码


●编号948,输入编号直达本文

●输入m获取文章目录
推荐↓↓↓
Web开发
更多推荐《25个技术类微信公众号
涵盖:程序人生、算法与数据结构、黑客技术与网络安全、大数据技术、前端开发、Java、Python、Web开发、安卓开发、iOS开发、C/C++、.NET、Linux、数据库、运维等。
分享到 :
0 人收藏
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

积分:55
帖子:11
精华:0
期权论坛 期权论坛
发布
内容

下载期权论坛手机APP