开启成长之旅!这是我参加「日新计划 2 月更文挑战」的第 5 天,点击查看活动详情
最近开发的时分遇到个格局化的问题,项目的几个开发人员用的格局化东西不一致,导致改代码格局化后总是有许多改动。为此研讨下 Prettier 一致代码格局化公安局。
Prettier 简介
Prettier 是一个武断的代码格局化东西,为什么说它武断呢,因为它不担任代码检查,只担任按它自己的一套规矩进行格局化。并且它的格局化可装备项也很少,上手很简单。(不过实践用下来格局化的作用很不错)
它支撑下面这些言语的格局化:
- JavaScript (including experimental features)
- JSX
- Angular
- Vue
- Flow
- TypeScript
- CSS, Less, and SCSS
- HTML
- Ember/Handlebars
- JSON
- GraphQL
- Markdown, including GFM and MDX
- YAML
运用 Prettier 对代码进行格局化
装置 Prettier
npm install --save-dev --save-exact prettier
装置后,需求在根目录装备两个文件
-
.prettierrc.json
用来装备 Prettier 的格局化方法,做到定制化。 -
.prettierignore
类似于 .gitignore 用来疏忽一些目录或者文件,在格局化是会疏忽他们。
对文件进行格局化
npx prettier --write .
如此,整个项目的文件都会被格局化。假如只想格局化某个目录下的文件,能够更改指令:
npx prettier --write ./src/views/
.prettierrc.json
prettier 的装备规矩文件。能够装备的装备项很少,算是比较有好的。具体可参阅官方装备文档
{
"semi": false,
"singleQuote": true,
"arrowParens": "always",
"htmlWhitespaceSensitivity": "ignore",
"trailingComma": "all"
}
.prettierignore
咱们运用 .prettierignore
来疏忽指定的文件和目录
# 疏忽目录或文件
build
coverage
# 疏忽所有 html 文件
*.html
别的还有两种能够疏忽格局化的方法:
第一种是加上 prettier-ignore
的注释来疏忽某些代码的格局化。
// prettier-ignore
第二种是在履行 prettier 指令的时分加上疏忽的文件后缀
prettier --write . '!**/*.{js,jsx,vue}'
VS Code 上装置 Prettier
上面提到的 Prettier 是经过指令行的方法对文件进行格局化的。
咱们还能够在修改器中运用 Prettier。运用的方法就是在修改器上装置 Prettier 的扩展。我这儿以 VS Code 为例,假如想查阅其他修改器的扩展装置方法能够参阅这儿
装置方法很简单,在 VS Code 侧边栏找到扩展,搜索 Prettier 就能够找到 Prettier – Code formatter了,装置后即可运用。
在装置完后,需求在 VS Code 装备中装备默认格局化方法:
"editor.defaultFormatter": "esbenp.prettier-vscode",
"[html]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[scss]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[less]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[json]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[vue]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
如此就能够经过 alt + shift + f
来进行格局化了。
在 Git Hooks 上加上 Prettier 格局化
方针是在每次 Git commit 的时分进行格局化。
首先需求装置 hushy 和 lint-stage
npm install --save-dev husky lint-staged
npx husky install
npm pkg set scripts.prepare="husky install"
npx husky add .husky/pre-commit "npx lint-staged"
然后在 package.json
中加入 hook 代码
{
"lint-staged": {
"**/*": "prettier --write --ignore-unknown"
}
}
一致 Prettier 的用法
既然装置了指令式的 prettier 和修改器扩展式的 prettier,那么他们假如不一致反复横跳就十分蛋疼了。
我就遇到某项目在多台电脑上的 VS Code 上运用 Prettier 格局化出的结果不一样,问题出在那个项目没有中并没有 prettierrc.json
装备文件,所以各个 VS Code 就依照系统装备中的规矩来进行了格局化。
在加上了装备文件后,发现装备文件并未收效。仍是各管各的。
所以,试着重启了 VS Code,再去进行格局化。结果,alt + shift + f
格局化出来的结果就和 npx prettier --write .
的作用一致了,都是照着 .prettierrc.json
来进行格局的。
其他
保存即格局化
在 VS Code 的装备中搜索 Format On Save
,找到装备项勾选后就能够在保存文件的时分进行格局化。
这样就能够省去每次都按 Shift + Alt + F
的时间了(尽管我仍是会经常习惯性按快捷键)
Prettier 格局化后,完毕标签的 > 换行了
<el-dropdown-item
v-for="option in indicatorOptions"
:command="option.value"
:key="option.value"
>{{ option.name }}</el-dropdown-item
>
这个代码格局就很反程序员,逼死强迫症了属所以。解决方案是修正 .prettierrc.json
装备文件。
{
...,
htmlWhitespaceSensitivity: “ignore”
}
<el-dropdown-item
v-for="option in indicatorOptions"
:command="option.value"
:key="option.value">
{{ option.name }}
</el-dropdown-item>
Prettier 完成原理
prettier 是根据修改技术完成的。其实像 webpack 这些编译东西、vue 和 react 转成原生的 JavaScript 也是类似的原理。
- 解析源码,将源码字符串转换成 AST 语法树。
- 对生成的 AST 做一些增删改处理。
- 将 AST 递归生成方针代码。
而 Prettier 的格局化是在第三部的时分进行的,依照它定义的代码格局进行格局化,并替换原有代码。
参阅文档
- prettier.io/
- /post/684490…
- /post/717252…