VSCode需通过扩展和配置接入ESLint或Pylint才能实现代码检查。必须安装对应官方扩展并禁用内置校验器(如javascript.validate.enable设为false),确保配置文件被正确识别(如.eslintrc.cjs优先),且工具为本地安装;Python还需指定虚拟环境及pylint路径。

VSCode 本身不自带代码检查能力,必须通过扩展和配置把 ESLint 或 Pylint 接入编辑器。直接装扩展不配规则,等于没开检查——尤其对新项目或团队协作,没正确配置会导致报错不显示、修复不生效、甚至和 CLI 行为不一致。
装对扩展 + 关闭内置检查
ESLint 和 Pylint 都需要对应语言的官方扩展,且必须禁用 VSCode 自带的语法提示干扰:
- JavaScript/TypeScript:装
ESLint扩展(由 Dirk Baeumer 维护),**不要只装 “JavaScript Booster” 或 “Auto Close Tag” 类辅助插件**;装完后在设置里搜javascript.validate.enable,设为false - Python:装
Python扩展(Microsoft 官方),再在设置里启用python.linting.enabled,并指定python.linting.pylintPath(比如"./venv/bin/pylint") - 关键点:如果项目根目录有
.eslintrc.cjs或pyproject.toml,但 VSCode 没反应,大概率是内置校验器抢跑了,关掉它最省事
ESLint 配置文件必须被识别到
VSCode 的 ESLint 扩展默认只认项目根目录下的配置文件,且格式敏感:
- 支持的文件名优先级(从高到低):
.eslintrc.cjs>.eslintrc.js>.eslintrc.json;eslint.config.js(新格式)需 VSCode 1.86+ 且扩展版本 ≥ 2.4.0 - 常见坑:
.eslintrc.js里用了 ESM 语法(如export default)会静默失败;改用module.exports = { ... } - 如果用
pnpm或bun,确保eslint是本地安装(pnpm add -D eslint),全局安装的 ESLint 扩展通常找不到
Pylint 要处理 Python 环境路径
Pylint 依赖具体 Python 解释器环境,VSCode 必须知道用哪个解释器启动它:
- 先用
Ctrl+Shift+P→Python: Select Interpreter指向项目虚拟环境(如./venv/bin/python) - 再确认
python.linting.pylintArgs设置里没硬编码错误路径;推荐用["--rcfile=pylintrc"]而不是绝对路径 - 若报错
ModuleNotFoundError: No module named 'pylint',说明当前解释器里没装 pylint:运行./venv/bin/python -m pip install pylint - Pylint 默认不检查未使用变量(
unused-argument),如需开启,要在配置里显式加enable=unused-argument
真正麻烦的从来不是“怎么装”,而是“为什么改了配置还不生效”——多数时候卡在路径没对上、扩展读错了配置文件、或者本地 node_modules / venv 里根本没装对应工具。每次怀疑配置失效,先看 VSCode 右下角状态栏的 ESLint / Pylint 图标有没有报错提示,比翻日志快得多。










