Pylint在VSCode不标红，本质是未真正运行：需指定虚拟环境解释器、安装pylint、启用python.linting.enabled和python.linting.pylintEnabled，并将.pylintrc置于项目根目录。
Pylint 在 VSCode 里不标红，基本就是没真正跑起来——不是扩展没装对，就是它根本没找到能执行的 pylint 命令。
VSCode 找不到 pylint 的三种典型表现
写个 import non_existent_module 没反应；“问题”面板空着；命令面板搜 Python: Run Linting 报错 ModuleNotFoundError: No module named 'pylint'。这些都不是配置“没生效”，而是 VSCode 根本没调起 pylint 进程。
- VSCode 的 Python 扩展默认只启用
pylsp（语言服务器），pylint是独立组件，必须显式开启 - 即使全局装了
pylint，VSCode 默认用你选中的 Python 解释器（比如./venv/bin/python）去调pylint——如果那个环境里没装，就直接失败 -
python.linting.pylintPath如果写成绝对路径（如/usr/local/bin/pylint），容易在换机器、换环境后失效；推荐用"pylint"（让系统 PATH 查找）或相对路径（如"${workspaceFolder}/.venv/bin/pylint"）
pylint 配置文件放哪才被 VSCode 认？
VSCode 不会递归扫描整个项目找 .pylintrc，它只按固定顺序检查几个位置：当前文件所在目录 → 上级目录 → 用户主目录（~/.pylintrc）→ 安装目录默认配置。最稳的方式是把配置文件放在项目根目录（即你用 VSCode “打开文件夹” 所选的那个文件夹顶层）。
- 文件名必须是
.pylintrc或pylintrc（无点）；pylint.rc、config.pylintrc都无效 - 如果用
pyproject.toml，Pylint 能读[tool.pylint]，但 VSCode 对 TOML 的支持不稳定，尤其老版本，建议仍用.pylintrc - 生成初始配置：终端进项目根目录，运行
pylint --generate-rcfile > .pylintrc，再按需修改 - 改完配置后必须重启窗口（
Ctrl+Shift+P→Developer: Reload Window），热更新不保证触发重载
为什么开了 python.linting.enabled 还不报错？
因为 VSCode 默认启用了 python.linting.pylintUseMinimalCheckers，这相当于只开少数几条规则（--disable=all --enable=F,E,unreachable,...），很多风格类警告（比如 missing-docstring、invalid-name）直接被关掉了。
- 关掉最小检查集：
"python.linting.pylintUseMinimalCheckers": false - 想禁用某类警告（如不强制文档字符串）：在
.pylintrc的[MESSAGES CONTROL]区块中，在disable=后追加，用英文逗号分隔，例如disable=missing-docstring,invalid-name - 要开启未使用参数检查（
unused-argument）这类默认关闭的规则，得在.pylintrc的enable=行显式加上，不能只靠取消disable
最容易被忽略的是：VSCode 终端的 PATH 和编辑器内部调用 CLI 工具时的 PATH 可能不一致。如果你在终端里能跑 pylint --version，但在 VSCode 里报“command not found”，大概率是这个原因——别只盯着 settings.json，先确认 venv/Scripts 或 node_modules/.bin 是否进了 VSCode 的环境变量。
