什么是更漂亮的文件注释?

What is the prettier file annotation for?

我见过一些以以下开头的 React 文件:

/**
 * @prettier
 */

这是什么用意?

这个词叫做pragma

Prettier 可以将自己限制为仅格式化在文件顶部包含特殊注释(称为 pragma)的文件。这在将大型、未格式化的代码库逐渐过渡到更漂亮时非常有用。

需要编译指示

Prettier 可以限制自己只格式化在文件顶部包含特殊注释(称为 pragma)的文件。这在将大型、未格式化的代码库逐渐过渡到更漂亮时非常有用。

例如,当提供 --require-pragma 时,将格式化以下列作为其第一个注释的文件:

/**
 * @prettier
 */

/**
 * @format
 */

API 覆盖:

requirePragma: <bool>