0

0

VSCode的“保存时格式化”功能深度定制

P粉986688829

P粉986688829

发布时间:2025-12-08 20:21:06

|

882人浏览过

|

来源于php中文网

原创

VSCode“保存时格式化”需依次配置:开启Editor: Format On Save开关、为语言绑定默认格式化器(如Prettier)、设置formatOnSaveExclude排除文件、协同ESLint时用eslint-config-prettier统一规则。

vscode的“保存时格式化”功能深度定制

VSCode 的“保存时格式化”不是开个开关就完事的,它背后涉及编辑器设置、语言专属配置、格式化工具链协同,甚至项目级覆盖规则。真正用好,得一层层理清逻辑。

核心开关:先确保基础能力开启

“保存时格式化”默认是关闭的,必须手动启用。这不是全局开关,而是按工作区或用户级别生效:

  • 打开设置(Ctrl+,Cmd+,),搜索 format on save
  • 勾选 Editor: Format On Save
  • 如需仅对当前项目生效,点击右下角齿轮图标 → Workspace Settings,再勾选

注意:仅开启此项,不代表代码真能被格式化——它只是触发动作,具体执行靠后面配置的格式化器。

格式化器绑定:告诉 VSCode “谁来干活”

VSCode 不自带格式化逻辑,它依赖你安装的扩展(如 Prettier、ESLint、Black、Pylint)并指定默认格式化器。关键步骤如下:

  • 安装对应语言的格式化扩展(例如:Prettier for JavaScript/TypeScript,Black Formatter for Python)
  • 在设置中搜索 default formatter,找到 Editor: Default Formatter
  • 点击下拉菜单,为特定语言选择格式化器(如:JavaScript → esbenp.prettier-vscode
  • 也可在项目根目录创建 .vscode/settings.json 显式声明:
    "editor.defaultFormatter": "esbenp.prettier-vscode"
    "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }

没有正确绑定格式化器,“保存时格式化”会静默失败,不报错也不生效。

ShopWind网店系统
ShopWind网店系统

ShopWind网店系统是国内最专业的网店程序之一,采用ASP语言设计开发,速度快、性能好、安全性高。ShopWind网店购物系统提供性化的后台管理界面,标准的网上商店管理模式和强大的网店软件后台管理功能。ShopWind网店系统提供了灵活强大的模板机制,内置多套免费精美模板,同时可在后台任意更换,让您即刻快速建立不同的网店外观。同时您可以对网模板自定义设计,建立个性化网店形象。ShopWind网

下载

细粒度控制:跳过某些文件或场景

不是所有文件都该被格式化。比如生成的代码、大型 JSON、或团队约定跳过的目录,可通过以下方式排除:

  • settings.json 中使用 editor.formatOnSaveExclude
    "editor.formatOnSaveExclude": ["**/node_modules/**", "**/dist/**", "**/*.min.js"]
  • 临时禁用单次保存格式化:保存前按住 Alt(Windows/Linux)或 Option(macOS),再按 Ctrl+S
  • 完全禁用某语言:在语言专属设置中设 "editor.formatOnSave": false(如对 Markdown 关闭)

进阶协同:和 ESLint / Prettier 配合不打架

当同时启用 ESLint 和 Prettier,容易出现冲突(比如 ESLint 要分号,Prettier 不要)。推荐做法是让 Prettier 做格式化,ESLint 只做代码质量检查,并统一规则:

  • 安装 ESLintPrettier 扩展
  • 在项目中安装 eslint-config-prettier(禁用 ESLint 中与 Prettier 冲突的规则)
  • 配置 .eslintrc.js
    extends: ['eslint:recommended', 'prettier']
  • VSCode 设置中,将 ESLint 设为默认格式化器("editor.defaultFormatter": "dbaeumer.vscode-eslint"),并开启 "eslint.format.enable": true —— 这样 ESLint 会调用 Prettier 做实际格式化,实现“一套规则,一次执行”

本质上,VSCode 的“保存时格式化”是调度器,而真正的格式逻辑、规则优先级、错误容忍度,都在你配的工具链里。

基本上就这些。不复杂但容易忽略细节:开关开了 ≠ 有活干,格式化器绑了 ≠ 规则对了,项目级配置比用户级更可靠。动手前,先看清自己用的是谁、管的是哪块、想放过的又是哪些。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

419

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

782

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

434

2024.06.27

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

514

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

244

2023.07.28

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

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

精品课程

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

共137课时 | 10万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号