VSCode怎样配置代码检查与质量工具【教程】

vscode需扩展与外部工具协同实现代码检查；须按语言选配兼容LSP和格式化器，正确配置settings.json禁用冲突选项，并确保项目级配置文件完备且PATH环境正常。

VSCode 本身不内置代码检查，得靠扩展 + 外部工具协同工作；配置错顺序或忽略语言服务器兼容性，eslint、pylint、prettier 很容易互相打架，报错却没提示、保存不自动修复是常态。

装对扩展：按语言选 LSP + 格式化器

不同语言依赖不同的语言服务器协议（LSP）实现诊断能力，不能只装一个“万能插件”：

• python：必须装 Python 官方扩展（含 Pylance），再单独配 pylint 或 flake8 —— pylsp 和 pyright 不能混用，否则类型检查和错误高亮会冲突
• javaScript/typescript：优先用内置的 typescript-language-server，额外加 ESLint 扩展（不是 eslint-plugin 那类辅助插件），禁用 TSLint（已废弃）
• go：只启用 gopls，别装旧版 go-outline 或 go-imports，它们和 VSCode 1.80+ 的模块管理不兼容

配置 settings.json：关掉自动格式化陷阱

很多人开 "editor.formatOnSave": true 后发现代码越改越乱，问题常出在格式化器和 linter 职责重叠：

• 禁用编辑器默认格式化："editor.formatOnSave": false，把控制权交给 prettier 或语言专属工具
• 让 ESLint 管修复："eslint.enable": true + "eslint.codeAction.showDocumentation": true，配合快捷键 Ctrl+Shift+P → ESLint: Fix all auto-fixable Problems
• 若坚持保存即格式化，必须指定格式化器："editor.defaultFormatter": "esbenp.prettier-vscode"，且确保项目根目录有 .prettierrc，否则 prettier 按默认规则跑，和 ESLint 规则对不上

项目级配置文件不能少：避免全局配置污染

全局设置看着省事，但团队协作时极易引发风格冲突。每个项目必须带自己的配置文件：

• package.json 中的 eslintConfig 字段优先级低于 .eslintrc.js，建议统一用 .eslintrc.cjs（支持 import 语法且兼容 node.js 14+）
• pyproject.toml 是 Python 项目的事实标准，[tool.pylint] 和 [tool.black] 要分开写，别试图用 pylint 做格式化
• 没有 tsconfig.json 的 TS 项目，typescript-language-server 会退化为 JS 模式，类型检查直接失效

最常被跳过的一步：确认 node_modules/.bin 或 venv/Scripts 在 VSCode 终端 PATH 里——扩展调用 CLI 工具失败时，不会弹错误框，只会静默禁用检查功能。