怎么在VSCode里自动整理代码-Prettier插件配置与使用教程

秋明姑娘_5866

秋明姑娘_5866

2026-05-03

358人浏览

原创

根本原因是VS Code未正确配置Prettier的执行路径、默认格式化器及规则文件。需在项目中安装prettier依赖,通过.vscode/settings.json指定editor.defaultFormatter、formatOnSave等,并配好.prettierrc;同时禁用ESLint格式规则与冲突插件。

怎么在vscode里自动整理代码-prettier插件配置与使用教程

装了 Prettier 插件却按 Shift+Alt+F 没反应,或者保存后代码没对齐——根本原因不是插件没装好,而是 VS Code 不知道该用什么规则、调哪个工具、处理哪些文件。

为什么装完插件还不能自动格式化

Prettier 插件本身不带默认规则,也不自带可执行的格式化器。它只是个“调度员”,真正干活的是你项目里装的 prettier 包(比如 node_modules/prettier)。如果项目没装、路径不对、或配置缺失,VS Code 就会卡在“没有可用的格式化程序”这一步。

  • 只装插件不装 prettier 依赖:运行 npm install --save-dev prettier 或 yarn add -D prettier
  • 用了 pnpm/yarn v4+ 但插件读不到本地 prettier:在 settings.json 里加 "prettier.prettierPath": "./node_modules/prettier/index.cjs"
  • 没配 .prettierrc 或 prettier.config.js:插件会 fallback 到极简默认值(比如 semi: false),但很多项目需要显式声明规则
  • 配置文件放错位置:VS Code 不会向上查找父目录的 .prettierrc,子项目必须自己放一份

怎么让保存时真正自动对齐

开启 editor.formatOnSave 只是第一步,关键还得告诉 VS Code “谁来干、对谁干、怎么干”。光靠全局设置容易误伤其他项目,推荐用工作区配置。

  • 在项目根目录建 .vscode/settings.json,写死以下三项:
    "editor.formatOnSave": true
    "editor.defaultFormatter": "esbenp.prettier-vscode"
    "editor.formatOnSaveMode": "modifications"(只格式化改过的行,避免大文件重排全篇)
  • 为非 JS/TS 文件手动绑定格式化器,比如 JSON 和 Markdown:
    "[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
    "[markdown]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
  • 别在用户设置里全局开 formatOnSave,否则打开别人的项目可能触发意外格式化

Prettier 和 ESLint 冲突时代码越整越乱

典型现象:保存后分号一会儿有、一会儿没;对象属性换行位置反复变。这不是 bug,是两个工具都在试图改同一段代码的格式。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 必须用 eslint-config-prettier 关掉 ESLint 所有格式类规则:运行 npm install --save-dev eslint-config-prettier,并在 .eslintrc.js 的 extends 数组末尾加上 "prettier"
  • 不要同时开 source.fixAll.eslint 和 editor.formatOnSave 做同一件事;推荐只留 "source.fixAll.eslint": true,再把 ESLint 配置成只检查不修复格式(靠 eslint-config-prettier 实现),最终格式化动作全交给 Prettier
  • 禁用 Beautify 等老式格式化插件,它们会抢走 Shift+Alt+F 快捷键

手动格式化失效或弹出“选择格式化程序”提示

按 Shift+Alt+F 后弹出菜单让你选,说明 VS Code 检测到多个可用格式化器,但没设默认项,或者当前文件类型没被绑定。

  • 先确认语言模式正确:右下角状态栏看是否显示 JavaScript、TypeScript 等,不是 Plain Text;点它可切换
  • 检查 settings.json 是否漏了语言专属配置,比如 Vue 项目要加:
    "[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
  • 快捷键被占用?在命令面板搜 Preferences: Open Keyboard Shortcuts,过滤 formatDocument 看绑定是否正常
  • 临时测试:删掉 .vscode/settings.json,只在用户设置里开 formatOnSave 和指定 defaultFormatter,看是否恢复——能恢复就说明工作区配置有冲突

最常被忽略的是:Prettier 配置文件必须存在且路径正确,VS Code 不会报错,只会静默 fallback 到不一致的默认行为。哪怕只想要单引号,也得明确写进 .prettierrc,不能指望插件 UI 里的开关覆盖全部场景。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1615

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

3532

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

2169

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1767

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2647

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1878

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1302

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1156

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

574

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程