如何在 VSCode 中使用 Prettier 格式化 Node.js 源代码

夏伟小哥_4477

夏伟小哥_4477

2026-06-25

740人浏览

原创

vscode 默认不格式化 .js 文件,因未显式绑定 prettier 且未启用语言专属 editor.formatonsave;必须在 [javascript] 配置块中设 "editor.formatonsave": true 和 "editor.defaultformatter": "esbenp.prettier-vscode",并确保项目已安装 prettier 包及正确配置 .prettierrc。

如何在 vscode 中使用 prettier 格式化 node.js 源代码

VSCode 默认不格式化 Node.js 代码(即 .js 文件),必须显式绑定 Prettier 并启用保存触发,否则按 Ctrl+S 完全没反应。

为什么 .js 文件保存时不格式化?

VSCode 对 JavaScript 文件默认使用内置的 vscode.typescript-language-features 格式器,Prettier 插件装了也不会自动接管。

  • 右下角状态栏打开一个 .js 文件,若显示的是 ESLint 或 None,说明 Prettier 没绑定成功
  • editor.formatOnSave 放在全局设置里无效——它只对语言特定配置块生效
  • 必须在 .vscode/settings.json 中为 [javascript] 显式开启:"[javascript]": {"editor.formatOnSave": true}
  • 扩展 ID 必须写对:"editor.defaultFormatter": "esbenp.prettier-vscode",写成 prettier 或 prettier-vscode 都会失败

本地 prettier 包是硬性依赖

Prettier 扩展本身不含 CLI,它只是调用你本地安装的 prettier 包;没装包会报错 Failed to load module 'prettier',且静默跳过格式化。

Json Schema Toolkit
Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载
  • 推荐在项目根目录运行:npm install --save-dev prettier(或 yarn add -D prettier)
  • 避免全局安装:npm install -g prettier 在 macOS + nvm 或 Windows 权限受限环境下常找不到可执行路径
  • 如需强制指定路径,加配置项:"prettier.pretterrcPath": "./node_modules/prettier"
  • Node.js 项目通常用 ESM,若配置文件是 .prettierrc.cjs,确保用 module.exports = {...};若项目是纯 ESM("type": "module"),则改用 .prettierrc.js 并用 export default

Node.js 场景下的关键配置项

Node.js 代码常见风格偏好(如无分号、单引号、宽松换行)需显式声明,否则 Prettier 会回退到默认规则。

  • "semi": false:禁用分号(Node.js 社区主流选择)
  • "singleQuote": true:避免模板字符串中混用双引号
  • "trailingComma": "all":对象/数组末尾逗号,提升 git diff 可读性
  • "printWidth": 100:比默认 80 更适合 Node.js 的长链式调用(如 fs.promises.readFile().then(...).catch(...))
  • 不要漏掉 .prettierignore:至少排除 node_modules/ 和 dist/,否则格式化整个依赖树会卡死

和 ESLint 共存时的最小冲突配置

ESLint 不该负责格式化,只做逻辑检查;否则保存时两者反复覆盖,导致代码“抖动”或报错。

  • 安装冲突消除插件:npm install --save-dev eslint-config-prettier
  • 在 .eslintrc.cjs 的 extends 数组里,把 "prettier" 放在**最后**:["eslint:recommended", "prettier"]
  • 禁用 ESLint 的自动修复:"eslint.enable": true 但不要设 "eslint.autoFixOnSave": true
  • 确认 VSCode 的 ESLint 扩展(dbaeumer.vscode-eslint)未启用 eslint.format.enable,否则它会抢走格式化权

最易被忽略的一点:修改 .prettierrc 后,VSCode 不会热重载——必须重启窗口或重新打开文件,否则新规则不生效。尤其当配置语法有误(比如 JSON 多了个逗号),Prettier 会静默失效,回退到默认样式,你却看不到任何提示。

相关文章

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

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

下载

相关标签:

vscode node.js js node

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

相关专题

更多
node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

2023.09.19

9709

8

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

2025.11.26

414

14

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

2026.02.10

741

17

JavaScript Node.js流处理与高效数据管道构建实践
JavaScript Node.js流处理与高效数据管道构建实践

本专题聚焦 Node.js 在大规模数据处理场景中的应用,系统讲解 Stream 流机制、背压控制、管道(Pipe)处理以及文件与网络数据流的高效传输方式。内容包括可读流、可写流、双工流与转换流的实现原理,并结合实际案例构建高性能数据处理管道,帮助开发者提升数据处理效率与系统吞吐能力。

2026.04.07

304

13

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

518

8

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

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

2023.06.30

1255

18

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

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

2023.07.21

2592

3

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

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

2024.03.14

1889

12

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

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

2024.03.14

1707

8

热门下载

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

精品课程

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