VSCode格式化排除项_指定特定文件夹不进行自动格式化

VSCode的“保存时自动格式化”不支持按文件夹排除，因editor.formatOnSa ve是全局开关且无format.exclude配置；真正控制排除的是Prettier、ESLint等工具自身的.ignore文件或规则，search.exclude和files.exclude仅影响搜索与资源管理器显示，与格式化流程无关。

很多开发者都遇到过这个困扰：明明在VSCode里设置了某些文件夹不参与搜索或显示，为什么保存时，里面的代码还是被自动格式化了？其实，问题的根源在于一个普遍的误解。

VSCode的editor.formatOnSa ve功能，本质上是一个全局开关。它本身并没有提供类似format.exclude这样的配置项，让你去按文件夹排除。真正掌握“生杀大权”、决定哪些文件该被格式化、哪些该被放过的，是背后具体的格式化工具本身，比如Prettier、ESLint或者TypeScript语言服务。VSCode只是那个负责“传话”和“触发”的角色。

为什么 search.exclude / files.exclude 对格式化完全无效

这里有个关键区分：search.exclude和files.exclude这两兄弟，管的是VSCode“自己家里”的事。

• search.exclude只影响Ctrl+Shift+F全局搜索的结果。
• files.exclude只控制资源管理器侧边栏里显示哪些文件和文件夹。

它们俩完全不参与代码格式化的流程。当你按下保存时，VSCode会直接把当前文件的路径交给配置好的格式化工具（例如Prettier），至于这个工具处不处理、怎么处理，VSCode就不管了。

所以，一个典型的错误场景就是：你在settings.json里给scripts文件夹加上了排除规则，满心以为万事大吉，结果保存时，scripts下的JS文件依然被Prettier整理得服服帖帖。

想验证这一点？有个简单的方法：关掉所有第三方格式化插件，只保留VSCode官方的TypeScript扩展，然后去保存一个.ts文件。如果它依然被格式化了，那就说明是TypeScript语言服务在起作用，这再次证明了格式化行为并非由VSCode的顶层设置直接控制。

Prettier 用户：用 .prettierignore 控制范围

如果你项目的主力格式化工具是Prettier，那么解决方案非常明确：使用项目根目录下的.prettierignore文件。

这个文件的语法和.gitignore几乎一模一样，路径规则都是相对于项目根目录来写的。

• 写法示例：

  node_modules/
  dist/
  build/
  scripts/deploy.js
  **/*.config.js

• 这里有个细节需要注意：以**/开头的规则会递归匹配所有子目录，而像scripts/这样不带前缀的，通常只匹配项目根目录下的那个顶层scripts文件夹。
• 当然，这一切生效的前提是：Prettier的VSCode插件（比如esbenp.prettier-vscode）已经启用，并且VSCode已经将默认格式化器设置为了Prettier（即配置了"editor.defaultFormatter": "esbenp.prettier-vscode"）。
• 如果规则不生效，首先检查一下VSCode状态栏的右下角，看看当前文件的语言模式旁边是否显示了“Prettier”。如果没有，那说明这个文件可能还没被纳入Prettier的管理范围。

ESLint + format on sa ve：靠 .eslintignore + rules 配合

对于使用ESLint并在保存时触发格式化的场景，排除逻辑稍微复杂一些，通常需要两层配合。

• 第一层，文件级忽略：这依靠.eslintignore文件。它的写法和.prettierignore类似，比如你可以写dist/**或coverage/来排除整个目录。
• 第二层，规则级禁用：有些文件比较特殊，比如自动生成的API客户端代码，你可能希望保留其原始格式。这时可以在文件顶部添加特定的ESLint注释，例如// eslint-disable-next-line prettier/prettier来临时关闭规则。
• 这里有个关键点：.eslintignore的作用是让ESLint跳过对匹配文件的lint和格式化检查。但它并不能阻止VSCode去调用ESLint。如果一个文件没有被.eslintignore匹配，即使所有规则都被关闭，它也可能因为ESLint的空配置而触发某些默认行为。
• 因此，一个比较稳妥的组合策略是：在.eslintignore中排除掉那些不需要检查的大目录（如构建产物），同时在ESLint配置的overrides字段中，为特定的文件模式（glob）关闭prettier/prettier这类格式化规则。

TypeScript 内置格式化：只能靠文件关联和 language-specific 设置

由TypeScript语言服务提供的内置格式化功能，情况又不一样。它没有类似.ignore的配置文件，所以排除起来需要一些“曲线救国”的方法。

• 方法一：语言专属设置 在项目或工作区的.vscode/settings.json中，可以针对TypeScript语言关闭保存格式化：

  "[typescript]": {
    "editor.formatOnSa ve": false
  }

  这种方法立竿见影，但有点“一刀切”——它会关闭所有.ts文件的保存时格式化。
• 方法二：修改文件关联 更精准的做法是利用files.associations设置。你可以把不想格式化的特定文件，关联到一种没有格式化功能的语言上，比如plaintext：

  "files.associations": {
    "src/generated/**/*.ts": "plaintext"
  }

  这样一来，这些文件根本不会被TypeScript语言服务加载，自然也就不会被格式化。但代价是它们会失去所有的TypeScript智能功能，比如类型提示、代码跳转和重命名重构。所以这通常只适用于纯粹的、无需编辑的生成代码。
• 需要注意的是，不要试图在[typescript]这样的语言块里使用**/generated/**这样的glob模式来精准排除。VSCode的语言专属设置不支持这种路径匹配语法，它通常只识别具体的文件后缀（如*.ts）或简单的通配符（如*.d.ts）。

说到底，理解这个问题的核心在于认清流程的先后顺序：格式化的排除行为，永远发生在工具链的下游，而不是在VSCode这个入口层。你看到的“一保存就格式化”，其实是这样一个链条：VSCode → （调用）→ Prettier/ESLint/TS → （这些工具读取各自的ignore文件或规则）→ 决定执行或跳过。任何试图在VSCode设置层面进行统一拦截的想法，最终都可能徒劳无功。解决问题的钥匙，始终握在具体的格式化工具手里。