改了 settings.json 但 pylint/flake8 没反应，常见原因是配置被工作区、远程容器或扩展默认值覆盖；需确保 python.linting.enabled 和对应 linter 开关均为 true，并确认解释器、linter 安装及路径正确。
为什么改了 settings.json 但 pylint/flake8 没反应？
常见原因是 VS Code 的 Python linting 配置被工作区设置、远程容器或扩展默认值覆盖。VS Code 会按「用户设置 → 工作区设置 → 文件夹设置」逐层合并，而 Python 扩展（如 ms-python.python）对 python.linting.* 相关配置有强依赖顺序。尤其注意：python.linting.enabled 必须为 true，且对应 linter 的启用开关（如 python.linting.pylintEnabled）也得显式设为 true，否则即使装了 pylint 也不会触发。
- 检查是否在
.vscode/settings.json（工作区级）而非全局用户设置里修改——多人协作项目应优先放这里 - 确认终端中能直接运行
pylint --version或flake8 --version，VS Code 不会自动帮你装 linter，只调用已安装的可执行文件 - 如果用了 conda/virtualenv，确保 VS Code 选对了 Python 解释器（
Ctrl+Shift+P→Python: Select Interpreter），否则可能找不到环境中安装的 linter
如何为不同项目单独配 pylint 规则？
直接在项目根目录的 .vscode/settings.json 里写死 python.linting.pylintArgs 是最稳妥的方式。VS Code 会把数组里的每个字符串当作命令行参数传给 pylint，所以你可以复用 pylintrc 文件，也能直接内联规则。
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
- 用
--rcfile指向项目专属配置："python.linting.pylintArgs": ["--rcfile=.pylintrc"]
- 禁用特定警告（比如不关心变量名长度）：
"python.linting.pylintArgs": ["--disable=C0103"]
- 启用额外检查（如类型注解）：
"python.linting.pylintArgs": ["--enable=missing-type-doc,missing-param-doc"]
- 注意：参数值含空格时不用加引号，VS Code 会自动处理；但像
--output-format=colorized这种非标准输出格式可能导致解析失败，建议只用text或留空
flake8 和 pylint 能不能同时开？
不能。VS Code 的 Python 扩展只允许启用一个 linter 实例，同时设 python.linting.pylintEnabled 和 python.linting.flake8Enabled 为 true 会导致后者静默失效——它会优先使用第一个设为 true 的 linter。
- 如果想兼顾两者，推荐用
pylint为主，再通过python.linting.pylintArgs加入flake8风格检查（例如--enable=missing-module-docstring,invalid-name已覆盖大部分flake8常规规则） - 或者换用
pylsp+pylsp-mypy等语言服务器方案，它们天然支持多插件并行，但需要额外配置pyproject.toml并关闭原生 linting - 真实场景中，
pylint的深度分析（如未使用变量、循环引用）比flake8更实用，除非团队强制要求pep8兼容性，否则没必要切
为什么改了 settings.json 后保存没立刻报错？
VS Code 的 linting 是延迟触发的：默认只在文件保存后或编辑停顿 500ms 后运行。更关键的是，它不会重新扫描整个项目，只检查当前打开的文件和最近修改过的文件。
- 手动触发：右键编辑器 →
Python: Run Linting，或快捷键Ctrl+Shift+P→ 输入Python: Run Linting - 检查输出面板：
Ctrl+Shift+U→ 选择Python，看是否有pylint启动失败或路径错误的日志 - 如果某文件始终不 lint，可能是它被
python.linting.ignorePatterns匹配到了（默认包含**/test_*.py和**/__pycache__/**） - 真正容易被忽略的一点：某些 linter 参数（如
--disable）只对当前文件生效，不会影响 import 链中的其他模块——也就是说，A.py 里禁用 C0103，但 B.py import A 后仍会因 B.py 自身变量名报 C0103
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
