VSCode代码纠错依赖外部linter（如ESLint、Pylint）而非自身，需正确安装扩展、配置项目级规则文件（如.eslintrc.js、.pylintrc）、确保语言模式识别准确，并区分格式化（Prettier）与纠错功能。
VSCode 本身不直接做代码纠错，真正干活的是你装的 linter（比如 pylint、eslint、mypy）或 formatter（比如 prettier）。所谓“自定义纠错规则”，本质是告诉这些工具：哪些问题要报、怎么报、报完要不要自动修。
确认当前生效的 linter 是哪个
右下角状态栏点语言标识（如 Python 或 JavaScript），再看旁边有没有 ESLint、Pylint 这类图标。没有？说明纠错根本没启用。常见原因：
- 没装对应扩展（比如 Python 项目没装
ms-python.flake8或ms-python.pylint） - 装了但没在命令面板运行
Python: Select Linter或ESLint: Enable/Disable - 项目根目录缺少配置文件（
.eslintrc.js、.pylintrc等），工具只能用默认规则
在项目级配置文件里关/开具体规则
不要只改 VSCode 用户设置（settings.json），那只能开关全局启用/禁用，不能细粒度控制规则。必须落到项目自己的配置文件里：
- JavaScript/TS 项目：编辑
.eslintrc.js，在rules字段里写：{"no-console": "warn", "no-unused-vars": "off"} - Python 项目：编辑
.pylintrc，在[MESSAGES CONTROL]下加：disable=missing-docstring,too-few-public-methods - 统一格式化：
.prettierrc控制缩进、引号、换行等，和纠错无关但常被混淆——它不报错，只重排
注意：VSCode 的 editor.codeActionsOnSave 可以配 source.fixAll.eslint，但前提是 ESLint 配置里该规则本身支持自动修复（标有 ✅ 的 rule）。
为什么改了规则还是不生效
最常见三个断点：
-
cSpell.enabled这类拼写检查配置，和代码逻辑纠错完全无关，别混在一起调 - 语言模式识别错误：右下角显示
Plain Text时，eslint规则压根不加载，先点它手动切到JavaScript - 配置文件路径不对：必须放在项目**根目录**，不是
src/或config/下；且文件名要匹配工具约定（.eslintrc.cjs比eslint.config.js兼容性更稳）
改完配置后，重启 VSCode 窗口（尤其是 Remote-SSH 场景），或手动触发 Developer: Reload Window。
避免把 editor.tokenColorCustomizations 当成纠错配置
有人把高亮颜色配置（editor.tokenColorCustomizations）和纠错规则搞混。前者只改文字颜色，后者才影响诊断信息（红色波浪线、悬停提示）。textMateRules 里写的 scope 再准，也改不了 no-undef 报不报错——那是 eslint 的事。
真正难的不是写规则，而是理解哪一层配置在起作用：编辑器设置管开关，语言扩展管能力，项目配置文件管细节。三者错位，纠错就成摆设。
