.Prettierrc文件的设置

15,014 阅读3分钟

因为用到了Prettier所以在设置的时候看文档发现全是英文索性就翻译了下希望大家能用到。

Prettier Option

.Prettierrc

Cli是在终端使用,

Api是在.Prettierrc中设置使用

printWidth

打印宽度指定打印将换行的行长。

Default Cli Override Api Override
80 --print-width printWidth:

Tab Width

指定每个缩进的空格数。

Default Cli Override Api Override
2 --tab-width tabWidth:

Tabs

Tab缩进而不是空格

Default Cli Override Api Override
false --use-tabs useTabs:

Semicolons

在语句的末尾打印分号。

有效的选项:

  • true - 在每个语句的末尾添加一个分号。
  • false - 只在可能引入ASI故障的行的开头添加分号。
Default Cli Override Api Override
true --no-semi semi:

Quotes

使用单引号而不是双引号。

Default Cli Override Api Override
false --single-quote singleQuote:

Trailing Commas

多行时,尽可能打印尾随逗号。 (例如,一个单行数组永远不会得到尾随的逗号。)

有效选项:

  • none - 没有尾随逗号。
  • es5 - 在ES5中有效的尾随逗号(object,arrays等)
  • all - 尽可能尾随逗号(包括函数参数)。
Default Cli Override Api Override
None --trailing-comma <none|es5|all> trailingComma: "<none|es5|all>"

Bracket Spacing

在对象文字中的括号之间打印空格。

选项:

  • true - Example { foo: bar }
  • flase - Example {foo: bar}
Default Cli Override Api Override
true --no-bracket-spacing bracketSpacing:

JSX Brackets

将多行JSX元素的 > 放在最后一行的末尾,而不是单独放在下一行(不适用于自闭元素)。

Default Cli Override Api Override
false --jsx-bracket-same-line jsxBracketSameLine:

Arrow Function Parentheses

围绕一个唯一的箭头函数参数包括括号。

选项:

  • avoid - 尽可能省略括号 Example: x => x
  • always - 总是包括括号 Example: (x) => x
Default Cli Override Api Override
avoid --arrow-parens <avoid|always> arrowParens: "<avoid|always>"

Range

只格式化文件的一部分。

这两个选项可用于格式化以给定字符偏移(分别包含和排除)开始和结束的代码。范围将延伸:

  • 返回到包含选定语句的第一行的开头。
  • 转到选定语句的末尾。

这些选项不能与cursorOffset一起使用。

Default Cli Override Api Override
0 --range-start rangeStart:
Infinity --range-end rangeEnd:

Parser

指定使用哪个分析器。

Babylon和流解析器都支持相同的JavaScript特性(包括Flow)。Prettier会自动从输入文件路径中推断解析器,所以你不需要改变这个设置。

Built-in parsers:

Default Cli Override Api Override
babylon --parser
--parser ./my-parser
parser: ""
parser: require("./my-parser")

FilePath

指定输入文件路径。这将被用来做解析器推理。

例如,以下将使用postcss解析器:

cat foo | prettier --stdin-filepath foo.css

Default Cli Override Api Override
None --stdin-filepath filepath: ""

Require pragma

Prettier可以限制自己只能格式化文件顶部包含特殊注释的文件,称为杂注。逐渐将大型,无格式的代码库转换为漂亮的代码库时,这非常有用。

例如,当提供--require-pragma时,将会格式化具有以下第一个注释的文件:

/**
 * @prettier
 */

or

/**
 * @format
 */
Default Cli Override Api Override
false --require-pragma requirePragma:

Insert Pragma

Prettier的可以在文件的顶部插入一个特殊的@format标记,指定文件已被格式化为Prettier。

Default Cli Override Api Override
false --insert-pragma insertPragma:

Prose Wrap

默认情况下,由于某些服务使用了对换行符敏感的呈现器,因此Prettier会按原样包装降价文本。

选项:

  • "always" - 如果超出了打印宽度,请将散的包好。
  • "never" - 不包散的。
  • "preserve" - 按原样包散的。
Default Cli Override Api Override
"preserve" --prose-wrap <always|never|preserve> proseWrap: "<always|never|preserve>"