前端工具 Prettier 详细使用流程（兼容ESLint）

一、简介

• 中文文档，英文官网。
  
• Prettier 是一个开箱即用的代码格式化程序。用来批量处理旧代码的统一，涉及引号、分号、换行、缩进等。支持目前大部分语言处理，包括 JavaScript、Flow、TypeScript、CSS、SCSS、Less、JSX、Vue、GraphQL、JSON、Markdown ，它通过解析代码并使用自己的规则。
  

二、安装使用

• vscode 需开启保存配置
  
  
• 安装方式：

• 方式一：vscode 安装插件 Prettier，正常在项目文件根目录添加配置文件即可，会自动检测。
  
• 方式二：npm
sh $ npm install --save-dev --save-exact prettier
  
• 方式三：yarn
sh $ yarn add --dev --exact prettier
  

• 配置文件有很多种写法，选一种就行，不用纠结，没必要给自己挖坑！

• .prettierrc
  
• .prettierrc.js 当前个人使用的
  
• .prettierrc.json 官方文档使用的
  
• prettier.config.js
  
• package.json 中配置 prettier 属性
  
• ...... (附：官网配置文件支持的命名方式，以及编写导出方式)
  

• 有安装 ESLint 的情况下，可以尝试将 Prettier 的配置偏向 ESLint 的校验结果。列一下常见的冲突点：
  sh 1、prettier 会默认把单引号变成双引号，然后 eslint 校验报错 2、js 每行代码后面会加一个分号，然后 eslint 校验报错 3、函数结束之后会加一个逗号，然后 eslint 校验报错 ......
  在项目根目录创建 .prettierrc.js，添加自己需要的配置，这里列了一下常用配置，包含上面冲突点的兼容，其他配置自动可额外添加(附：官方文档支持的配置属性)
  js module.exports = { printWidth: 100, tabWidth: 2, // 超过最大值换行 semi: false, // 结尾不用分号 singleQuote: true, // 使用单引号 disableLanguages: ['vue'], // 不格式化 vue 文件，vue 文件的格式化单独设置 htmlWhitespaceSensitivity: 'ignore', // 标签换行不完整问题 trailingComma: 'none', // 函数后面不加逗号，如果不写这一个，在methods 最后一个函数也会加逗号，eslint会报错，多了一个逗号 }
  
• 项目中配置好之后，Ctrl + S 或 Command + S 保存
  如果保存无效，并没有进行格式化，在代码中右键菜单中，找到 使用...格式化文档 修改格式化文档方式为 Prettier，然后再次尝试保存，或者在右键菜单中直接点击 格式化文档。
  
• 可以忽略指定文件夹或文件中代码不进行格式化，以免提交出现冲突，创建 .prettierignore 文件，它使用的是 gitignore 语法。
  ```sh
  Ignore artifacts:
  build coverage
  Ignore all HTML files:
  *.html ```
  

三、补充

• 基本配置效果对比
  js { // tab 缩进大小，默认为 2 "tabWidth": 4, // 使用 tab 缩进，默认 false "useTabs": false, // 使用分号, 默认 true "semi": false, // 使用单引号, 默认 false (在 jsx 中配置无效, 默认都是双引号) "singleQuote": false, // 行尾逗号，默认 none ,可选 none|es5|all // es5 包括 es5 中的数组、对象 // all 包括函数对象等所有可选 "TrailingCooma": "all", // 对象中的空格 默认true // true: { foo: bar } // false: {foo: bar} "bracketSpacing": true, // JSX 标签闭合位置 默认 false // false: <div // className="" // style={{}} // > // true: <div // className="" // style={{}} > "jsxBracketSameLine": false, // 箭头函数参数括号 默认 avoid 可选 avoid| always // avoid 能省略括号的时候就省略 例如x => x // always 总是有括号 "arrowParens": "avoid" }
  
• vscode 安装插件之后，除了在项目中添加配置文件之外，也可以直接配置到 vscode 的配置文件( settings.json )中，这样就不需要每个项目添加配置文件了
  

js // prettier配置，，修改了配置文件，必须重启 vscode 才会生效 "prettier.configPath": "/Users/xxx/Desktop/Project/npm/dts-gen/.prettierrc.js", // 配置文件路径，配置了这个路径，就不需要单个配置了，要不然会覆盖 "eslint.alwaysShowStatus": true, // 总是显示 eslint 状态 "prettier.printWidth": 120, // 超过最大值换行 "prettier.tabWidth": 2, // 缩进字节数 "prettier.useTabs": false, // 缩进不使用 tab，使用空格 "prettier.semi": true, // 句尾添加分号 "prettier.singleQuote": true, // 使用单引号代替双引号 "prettier.proseWrap": "preserve", // 默认值。因为使用了一些折行敏感型的渲染器(如 GitHub comment)而按照 markdown 文本样式进行折行 "prettier.arrowParens": "avoid", // (x) => {} 箭头函数参数只有一个时是否要有小括号。avoid：省略括号 "prettier.bracketSpacing": true, // 在对象，数组括号与文字之间加空格 "{ foo: bar }" "prettier.endOfLine": "auto", // 结尾是 \n \r \n\r auto "prettier.eslintIntegration": false, // 不让 prettier 使用 eslint 的代码格式进行校验 "prettier.htmlWhitespaceSensitivity": "ignore", // 标签换行不完整问题 "prettier.ignorePath": ".prettierignore", // 不使用 prettier 格式化的文件填写在项目的.prettierignore文件中 "prettier.BracketSameLine": false, // 在 jsx中 把 '>' 是否单独放一行 "prettier.jsxSingleQuote": false, // 在 jsx 中使用单引号代替双引号 // "prettier.parser": "babylon", // 格式化的解析器，默认是 babylon "prettier.requireConfig": false, // Require a 'prettierconfig' to format prettier "prettier.stylelintIntegration": false, // 不让 prettier 使用 stylelint 的代码格式进行校验 "prettier.trailingComma": "none", // 属性值 es5 表示在对象或数组最后一个元素后面是否加逗号(在ES5中加尾逗号) "prettier.tslintIntegration": false, // 不让 prettier 使用 tslint 的代码格式进行校验