Pylint在VSCode中不标红，是因为未正确配置解释器、未启用pylint检查或配置文件位置错误；需通过Python: Select Interpreter指定虚拟环境、安装pylint、启用python.linting.enabled和python.linting.pylintEnabled，并将.pylintrc或pyproject.toml置于项目根目录。
VSCode 默认不检查 Python 代码，装了 Pylint 扩展但没报错，大概率是路径没对上、配置没生效，或者根本没在项目根目录下运行。
为什么 Pylint 在 VSCode 里不标红？
常见现象：写完 import non_existent_module，编辑器毫无反应；打开“问题”面板空空如也；命令面板搜 Python: Run Linting 报错 ModuleNotFoundError: No module named 'pylint'。
- VSCode 的 Python 扩展默认只启用
pylsp（语言服务器），pylint是额外可选组件，必须手动开启 - 它不会自动扫描整个项目找
.pylintrc或pyproject.toml，只认当前文件所在目录 → 上级目录 → 用户主目录（~/.pylintrc）→ 安装目录默认配置 - 即使你全局装了
pylint，VSCode 默认优先用项目虚拟环境里的解释器——如果./venv/bin/python里没装pylint，就直接失效
如何让 Pylint 真正启动并读到配置？
关键不是“装插件”，而是让 VSCode 明确知道：用哪个解释器、启哪个 linter、读哪份配置。
- 先用
Ctrl+Shift+P→Python: Select Interpreter指向你的虚拟环境（比如./venv/bin/python） - 确认该解释器里已安装：
./venv/bin/python -m pip install pylint（别用pip install pylint全局装） - 在设置中启用：
python.linting.enabled设为true，同时设python.linting.pylintEnabled为true，其他 linter（如flake8）设为false - 配置文件放对位置：项目根目录下放
.pylintrc（推荐用pylint --generate-rcfile > .pylintrc生成），或在pyproject.toml中写[tool.pylint]区块
常见报错和绕过方法
报错本身不提示，但行为异常就是线索。比如 import 报错、未使用变量不提醒、docstring 警告关不掉——基本都卡在路径或配置加载环节。
-
Import "xxx" could not be resolved：Pylint 默认把当前文件所在目录当sys.path[0]，源码在src/下时需加init-hook='import sys; sys.path.append("./src")'到.pylintrc的[MESSAGES CONTROL]上方 - 改了
.pylintrc但没反应：删掉 VSCode 缓存，重启编辑器；再不行，打开Ctrl+Shift+P→Developer: Toggle Developer Tools，看 Console 是否有Failed to load config file - 想禁用某类警告（如
missing-docstring）：在.pylintrc的[MESSAGES CONTROL]下的disable=行末尾追加，用英文逗号分隔，例如disable=missing-docstring,invalid-name
最麻烦的永远不是“怎么配”，而是“VSCode 没告诉你它根本没调用 pylint”。只要终端里 ./venv/bin/python -m pylint your_file.py 能跑出结果，而编辑器里没反应，那一定是解释器、路径或配置文件位置三者之一没对齐。
