必须同时开启python.linting.enabled和python.linting.pylintenabled；解释器需与pylint安装环境一致；.pylintrc须置于项目根目录且命名正确；output面板可查真实启动日志。
python.linting.enabled 和 pylint 子开关都开了吗？
VSCode 默认完全禁用所有 linter，装了 pylint 或 flake8 不代表它在运行。必须同时启用两个设置：python.linting.enabled（总开关）和 python.linting.pylintEnabled（pylint 专用开关）。只开前者、关后者，pylint 就是静默失效。
打开设置（Ctrl+, 或 Cmd+, ），搜这两个关键词，确认都为 true。别信“已安装”就等于“已启用”——这是最常被跳过的一步。
解释器选对了吗？pylint 真在那个环境里吗？
VSCode 的 Python 扩展不会从系统 PATH 找 pylint，而是严格从当前选中的 Python 解释器环境里找。你 pip install pylint 装在哪，就得让 VSCode 用哪个解释器。
- 按 Ctrl+Shift+P（或 Cmd+Shift+P）执行
Python: Select Interpreter，选中你项目实际用的环境（比如.venv/bin/python或env/Scripts/python.exe） - 在 VSCode 集成终端里运行
which pylint（macOS/Linux）或where pylint（Windows），输出路径必须和你选的解释器路径能对上 - Windows 用户特别注意：
C:\Program Files\这类含空格路径容易导致pylint启动失败，优先用虚拟环境
.pylintrc 放对位置了吗？名字写对了吗？
VSCode 不会递归搜索配置文件，它只按固定顺序检查几个位置：当前文件所在目录 → 上一级 → 用户主目录（~/.pylintrc）→ 最后才用内置默认。最稳做法就是把配置文件直接扔进项目根目录（即你用 VSCode “Open Folder” 打开的那个文件夹）。
- 文件名必须是
.pylintrc或pylintrc（无点也行），pylint.rc、config.pylintrc都无效 -
pyproject.toml里的[tool.pylint]段 VSCode 加载不稳定，不建议依赖 - 改完
.pylintrc后，执行Developer: Reload Window（Ctrl+Shift+P 调出），热更新不一定触发
为什么保存没反应、也没波浪线？先看 Output 面板
别只盯着编辑器界面。按 Ctrl+Shift+U（或 Cmd+Shift+U）打开 Output 面板，从下拉菜单里选 Python 或 PyLinter，里面会打印真实启动日志。常见线索包括：
-
Command 'pylint' not found→ 解释器没选对，或pylint没装在该环境 -
Failed to load config file→.pylintrc路径错、权限不够、或语法错误（比如 YAML 缩进错） - 空白或只有
Starting Pylint...后无下文 → 可能卡在 import 路径，需加--init-hook参数
真正难排查的不是“没报错”，而是“没日志”——那说明 linter 根本没走到执行阶段，问题一定出在前三个环节里。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
