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

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

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

VSCode 的「保存时自动格式化」不支持按文件夹排除，editor.formatOnSave 是全局开关，没有内置的 format.exclude 配置项。真正能控制“哪些文件夹不格式化”的，是格式化工具本身（比如 Prettier、ESLint、TypeScript）的配置，不是 VSCode 自身设置。

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

search.exclude 只影响 Ctrl+Shift+F 搜索；files.exclude 只影响侧边栏显示——两者都不参与代码格式化流程。格式化动作由语言服务器或外部 CLI 工具触发，VSCode 仅负责调用它们。所以你在 settings.json 里加再多排除规则，对保存时格式化毫无作用。

常见错误现象：在 search.exclude 里写了 "**/scripts/**": true，结果 scripts 下的 JS 文件照常被 Prettier 格式化
根本原因：VSCode 不解析、不拦截格式化请求，它只把当前文件路径传给 Prettier 或 ESLint，是否处理由后者决定
验证方式：关掉所有插件，只留官方 TypeScript 扩展，再试一次保存——如果 .ts 文件仍被格式化，说明是 TS 语言服务在起作用，不是 VSCode

Prettier 用户：用 .prettierignore 控制范围

如果你用 Prettier 做格式化，必须靠项目根目录下的 .prettierignore 文件，语法和 .gitignore 一致，路径相对于项目根目录。

VSCode

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

下载

写法示例：

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

注意：**/ 开头的规则会递归匹配，但 scripts/ 这种不带 **/ 的只匹配顶层目录
生效前提：Prettier 插件必须启用（如 esbenp.prettier-vscode），且 VSCode 的默认格式化工具设为 Prettier（"editor.defaultFormatter": "esbenp.prettier-vscode"）
不生效？检查 VSCode 状态栏右下角是否显示 “Prettier”，没显示说明当前文件没被识别为 Prettier 管理范围

ESLint + format on save：靠 .eslintignore + rules 配合

当使用 ESLint 的 eslint.format.enable 或通过 eslint.codeAction.onSave.mode = "format" 触发格式化时，排除逻辑分两层：

第一层（文件级忽略）：靠 .eslintignore，写法同 .prettierignore，例如：dist/**、coverage/
第二层（规则级禁用）：某些文件需要保留原始风格（如生成的 API client），可在对应文件顶部加注释：// eslint-disable-next-line prettier/prettier
关键限制：ESLint 的 ignore 文件只跳过 lint 和格式化执行，但不会阻止 VSCode 调用它——如果文件没被 .eslintignore 匹配，即使规则全关，也可能因空配置触发默认行为
推荐组合：在 .eslintignore 排除大目录，在 overrides 里为特定 glob 关闭 prettier/prettier 规则

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

TypeScript 语言服务的格式化无法用 ignore 文件控制，但可通过 VSCode 的语言专属设置绕行：

在 .vscode/settings.json 中写：
```
"[typescript]": {
  "editor.formatOnSave": false
}
```
——这会让所有 .ts 文件跳过格式化，但太粗暴
更精准做法：用 files.associations 把不想格式化的文件映射成非 TS 语言，例如：
```
"files.associations": {
  "src/generated/**/*.ts": "plaintext"
}
```
，这样 TS 语言服务根本不会加载它
副作用：这些文件失去类型提示、跳转、重命名等所有 TS 功能，仅适合纯生成代码
别试图用 **/generated/** 这类 glob 放在 [typescript] 块里——VSCode 不支持 glob 语法的语言设置，只认精确后缀或通配符 *.d.ts