Prettier在VSCode中稳定格式化的关键步骤包括：一、安装并启用官方Prettier扩展；二、在settings.json中禁用JS/TS内置格式器并设Prettier为默认格式化工具；三、项目根目录配置.prettierrc文件；四、开启保存时自动格式化；五、通过eslint-config-prettier解决与ESLint的规则冲突。

如果您在使用 VSCode 编辑代码时发现格式混乱、缩进不一致或括号风格杂乱，很可能是 Prettier 扩展未正确配置或未生效。以下是让 Prettier 在 VSCode 中稳定执行代码格式化的多种方法：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装并启用 Prettier 扩展

Prettier 必须作为 VSCode 扩展安装才能参与编辑器的格式化流程，仅靠全局 npm 安装无法触发编辑器内自动格式化。

1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。

2、在搜索框中输入 Prettier - Code formatter，确保作者为 Esben Petersen。

3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。

二、设置默认格式化工具为 Prettier

VSCode 默认可能使用内置格式化器或其他已安装扩展，必须显式指定 Prettier 为当前工作区或全局的默认 JavaScript/TypeScript/Markdown 等语言的格式化程序。

1、按下 Cmd+, 打开设置界面，在右上角点击“打开设置（JSON）”图标。

2、在 settings.json 文件中添加以下配置项：

3、对于 JavaScript 和 TypeScript："javascript.format.enable": false, "typescript.format.enable": false。

4、指定默认格式化器："editor.defaultFormatter": "esbenp.prettier-vscode"。

三、配置 Prettier 配置文件

仅依赖 VSCode 设置无法覆盖项目级格式偏好，Prettier 会优先读取项目根目录下的配置文件（如 .prettierrc 或 prettier.config.js），这是实现团队统一格式的关键环节。

1、在项目根目录新建文件 .prettierrc。

2、写入标准 JSON 格式配置，例如：{"semi": true, "singleQuote": true, "tabWidth": 2}。

3、保存后重启 VSCode 窗口，或执行命令面板（Cmd+Shift+P）中的 Developer: Reload Window。

四、启用保存时自动格式化

手动触发格式化易被忽略，开启保存即格式化可确保每次提交前代码均符合预设规范，避免格式污染。

1、打开设置（Cmd+,），搜索 format on save。

2、勾选 Editor: Format On Save 选项。

3、为防止与其他格式化器冲突，同时设置："editor.formatOnSaveMode": "modifications"。

五、解决 Prettier 与 ESLint 冲突

当项目同时使用 ESLint 进行代码检查时，其修复功能（eslint --fix）可能与 Prettier 的格式规则反向冲突，导致保存后反复修改同一行。

1、在项目中安装 eslint-config-prettier 并将其加入 ESLint 配置的 extends 数组末尾。

2、确保不启用 ESLint 的格式类规则，例如 "no-mixed-spaces-and-tabs" 或 "indent"。

3、在 VSCode 设置中禁用 ESLint 的自动修复："eslint.autoFixOnSave": false，改由 Prettier 全权负责格式化。

# javascript  # java  # vscode  # js  # markdown  # json  # typescript  # npm