什么是更漂亮的文件注釋？

Question

我見過一些以以下開頭的 React 文件：

/**
 * @prettier
 */

這樣做的意圖是什么？

Answer 1

該術語稱為pragma

Prettier 可以將自身限制為僅在文件頂部包含稱為 pragma 的特殊注釋的格式文件。 當逐漸將大型未格式化的代碼庫轉換為更漂亮的代碼時，這非常有用。

Answer 2

需要編譯指示

Prettier 可以將自身限制為僅在文件頂部包含稱為 pragma 的特殊注釋的格式文件。 當逐漸將大型未格式化的代碼庫轉換為更漂亮的代碼時，這非常有用。

例如，當提供 --require-pragma 時，將格式化具有以下內容作為其第一條注釋的文件：

/**
 * @prettier
 */

或者

/**
 * @format
 */

API 覆蓋：

requirePragma: <bool>