Prettier

启用自动 Prettier 配置

1. 打开 设置 对话框（Ctrl+Alt+S ），转到 语言与框架 | JavaScript | Prettier ，然后选择 自动 Prettier 配置。

   

2. 若要自动将 Prettier 应用于已保存的文件，请勾选 保存时运行 复选框。

3. 在 对文件运行 字段中，指定在保存此类文件或调用 重新格式化代码 操作时将自动应用 Prettier 的文件模式。

   在默认模式下，Prettier 将应用于任意 JavaScript、TypeScript、JSX、TSX、HTML、Vue 或 Astro 文件。 若要重新格式化其他类型的文件或特定文件夹中的文件，请使用 glob patterns 来更新默认模式。

   • 例如，若要自动重构 CoffeeScript 文件，请将 coffee 添加到默认模式中，如下所示：

     **/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,coffee}

   • 如需格式化某个特定文件夹中的文件（包括其子文件夹），请将 **/* 替换为 <path to the folder>/**/*。

     假设您有一个具有以下结构的项目：

     

     若要仅格式化 coffee 文件夹中的文件，请按如下方式更新模式：

     coffee/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,coffee}

     因此，文件 reformat.coffee 会被重新格式化，而 no_reformatting.coffee 不会。

   有关更多信息，请参阅 保存时自动运行 Prettier 和 设置 Prettier 为默认格式化程序。

1. 打开 设置 对话框（Ctrl+Alt+S ），转到 语言与框架 | JavaScript | Prettier ，然后选择 手动 Prettier 配置。

2. 从 Prettier 包 列表中，选择要使用的 prettier 安装。 如果您遵循了标准安装流程，WebStorm 会自动定位 prettier 包并自动填写该字段。

   

3. 要 将 Prettier 设置为默认格式化工具 ，请勾选 在“重新格式化代码”操作时运行 复选框。

4. 若要自动将 Prettier 应用于已保存的文件，请勾选 保存时运行 复选框。

5. 配置 Prettier 应用范围。

1. 在 设置 对话框（Ctrl+Alt+S ）中，转到 语言与框架 | JavaScript | Prettier。

2. 在 对文件运行 字段中，指定在保存此类文件或调用 重新格式化代码 操作时将自动应用 Prettier 的文件模式。

   在默认模式下，Prettier 将应用于任意 JavaScript、TypeScript、JSX、TSX、HTML、Vue 或 Astro 文件。 若要重新格式化其他类型的文件或特定文件夹中的文件，请使用 glob patterns 更新默认模式。

   • 例如，若要自动重构 CoffeeScript 文件，请按如下方式将 coffee 添加到默认模式中：

     **/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,coffee}

   • 如需格式化某个特定文件夹中的文件（包括其子文件夹），请将 **/* 替换为 <path to the folder>/**/*。

     假设您有一个结构如下的项目：

     

     仅格式化 coffee 文件夹内的文件，请按如下方式更新模式：

     coffee/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,coffee}

     因此，文件 reformat.coffee 被重新格式化，而 no_reformatting.coffee 不会。

   有关更多信息，请参阅 保存时自动运行 Prettier 和 设置 Prettier 为默认格式化程序。

3. 指定要使用的 .prettierignore 文件。

   对于匹配 上述指定模式 的每个文件，WebStorm 会默认向上搜索 .prettierignore 并使用找到的第一个配置文件。 每当选择 自动 Prettier 配置 时，始终应用此默认方式。

   使用 手动 Prettier 配置 时，默认情况下 .prettierignore 路径 字段还会显示 Detect the .prettierignore file automatically。 接受此建议，或单击 并选择要使用的 .prettierignore 。

4. 默认情况下，无论项目树中更高层的 node_modules 文件夹是否包含 prettier 包，Prettier 都会自动应用于每个匹配 上述指定模式 的文件。 这使您能够在所有子项目中使用 Prettier，而无需在每个子项目中安装 prettier 包。

   若要禁止处理没有 prettier 包的子项目中的文件，请选择 手动 Prettier 配置 并取消选中 对 Prettier 依赖范围之外的文件应用 Prettier 复选框。