VSCode中Pylint不报错，是因为未同时启用python.linting.enabled和python.linting.pylintEnabled、未通过“Python: Select Interpreter”选对含pylint的解释器、或.pylintrc未置于项目根目录。
VSCode 默认不启用任何 Python linter，装了 pylint 或 flake8 并不等于它在工作——必须手动打开开关、选对解释器、配对配置文件，三者缺一不可。
为什么 VSCode 里 pylint 没报错？先确认它真在运行
常见现象是写完代码没波浪线、保存也没提示，但终端里 pylint --version 能跑通。问题往往出在 VSCode 没“认到”你装的 linter。
-
python.linting.enabled和python.linting.pylintEnabled必须同时设为true；只开总开关、关掉子开关，pylint就是哑的 - 按
Ctrl+Shift+P（或Cmd+Shift+P）执行Python: Select Interpreter，选中你项目实际用的 Python 环境（比如.venv/bin/python）；如果选了系统 Python，但pylint只装在虚拟环境里，就会报Command 'pylint' not found - Windows 用户注意：若 Python 装在
C:\Program Files\这类带空格路径下，pylint常因 shell 解析失败静默退出；建议统一用虚拟环境，路径无空格
.pylintrc 文件放哪才生效？路径和命名有严格优先级
VSCode 不会递归扫描整个项目找配置文件，它只检查几个固定位置，且顺序明确：当前文件所在目录 → 上一级目录 → 用户主目录（~/.pylintrc）→ 最后才是默认内置配置。
- 最稳妥做法：把
.pylintrc放在项目根目录（即你用 VSCode “Open Folder” 打开的那个文件夹），和pyproject.toml或README.md同级 - 文件名必须是
.pylintrc或pylintrc（无点）；pylint.rc、config.pylintrc都无效 - 虽然
pyproject.toml支持[tool.pylint]段，但 VSCode 对 TOML 的加载不稳定，实测容易漏读，不建议作为主力配置方式 - 改完
.pylintrc后需执行Developer: Reload Window（Ctrl+Shift+P调出），热更新不保证触发
如何禁用烦人的警告？别直接关全局，用 disable 列表精准控制
像 C0116（missing-function-docstring）或 W0613（unused-argument）这类提示，在原型开发或测试脚本里常属干扰项。直接关掉整个检查模块（如 disable=all）会漏掉真正危险的问题。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 在
.pylintrc的[MESSAGES CONTROL]段里用逗号分隔禁用项：disable=missing-function-docstring,unused-argument - 避免用模糊匹配：比如
disable=missing-会误关所有含 missing 的规则，包括missing-module-docstring（C0114）和missing-class-docstring（C0115） - 若只想临时忽略某一行，加注释：
# pylint: disable=unused-argument；但不要滥用，这会绕过编辑器检查 - 行宽限制建议设为
max-line-length=88，与black默认值对齐，避免格式化后 lint 又报错
多个 linter 能同时开吗？可以但不推荐
VSCode 允许在 settings.json 里把 pylintEnabled 和 flake8Enabled 都设为 true，但实际效果是：只有第一个启用的 linter 生效（按字母顺序，flake8 会覆盖 pylint），其余被静默忽略。
- 想混用（比如用
flake8查风格、mypy查类型），得靠pyproject.toml+ 外部工具链，VSCode 内置 linting 不支持多引擎并行输出 - 企业级项目建议只用
pylint，它覆盖flake8+mccabe+ 基础类型推导；轻量项目用flake8更快，内存占用低 - 如果启用了
editor.codeActionsOnSave的source.fixAll，注意pylint本身不提供自动修复，真正起作用的是autopep8或black—— 它们属于 formatting 层，和 linting 是两套机制
最容易被忽略的一点：VSCode 的 Python 扩展每次更新都可能重置 linter 启用状态，尤其升级到 v2026.x 后，python.linting.* 相关设置已逐步标记为 deprecated，后续会迁移到 python.defaultInterpreterPath + python.linting.tool 新配置体系。现在就该习惯把核心规则固化在项目级 .pylintrc 里，而不是全押在用户 settings.json 上。
