VSCode需配置外部工具才能检测Python复杂度：Pylint必须与所选解释器同环境且pylintrc置于项目根目录；flake8通过"python.linting.flake8Args"设--max-complexity=6最简生效；CodeMetrics仅在.py文件、光标位于函数体内时显示指标，且受语法错误影响。
VSCode 本身不提供 Python 代码复杂度检测能力，必须靠外部工具 + 正确配置才能生效；光装插件、不装 pylint 或 flake8 包，或没选对 Python 解释器，状态栏永远显示“无问题”——实际是根本没跑起来。
为什么 Pylint 显示 N/A 或完全不报复杂度？
常见现象：函数明明嵌套了 5 层 if，Pylint 却不标红、不提示 Cyclomatic complexity；或者状态栏一直显示 N/A。
- 根本原因不是插件失效，而是 VSCode 没调起真正的
pylint可执行文件——它只在你选中的 Python 解释器环境里找pylint，而不是系统 PATH - 确认方式：在 VSCode 集成终端中运行
which pylint（macOS/Linux）或where pylint（Windows），输出路径必须和你通过Ctrl+Shift+P → Python: Select Interpreter选中的解释器在同一虚拟环境内 -
.pylintrc必须放在项目根目录（即打开的文件夹顶层），名字不能是pylint.rc或config.pylintrc；否则--max-complexity=6这类规则压根不加载 - 如果用的是
pip install pylint --user全局安装，VSCode 很可能找不到，尤其当解释器是 venv 时——建议统一用pip install pylint在激活的项目环境中安装
flake8 的 --max-complexity 怎么真正生效？
flake8 是唯一开箱即用、无需额外配置文件就能启用复杂度检查的方案，但它的命令行参数必须透传给 VSCode 才能自动触发。
- 在
settings.json中添加："python.linting.flake8Args": ["--max-complexity=6"]—— 注意是flake8Args，不是flake8Enabled，后者只是开关 - 别写成
--max-complexity 6（空格分隔），必须是等号连接，否则 VSCode 解析失败，参数被静默丢弃 -
flake8的复杂度计算基于 NedBatchelder’s McCabe script，和 Pylint 算法一致，但更轻量；它不会报告M（维护性指数）或L（逻辑行数），只给一个数字，适合快速卡阈值 - 错误码格式为
C901（例如test.py:42:5: C901 'process_data' is too complex (7)），这个C901必须出现在设置里启用的规则中，否则不显示
CodeMetrics 插件对 Python 支持有限制
CodeMetrics 看起来最方便——状态栏实时显示 C: x M: y L: z，但它对 Python 的支持是“有且仅当”满足以下全部条件：
- 文件后缀必须是
.py，且 VSCode 正确识别为 Python 语言（右下角显示 “Python”，不是 “Plain Text”） - 光标必须落在函数定义体内部（比如
def foo():后的大括号或冒号后缩进区），停在class行、空行、docstring 上都会显示N/A - 不支持
async def函数的自动识别（截至 2026 年 6 月最新版仍会漏判），需手动加def声明或改用flake8补位 - 阈值设太低（如
"codemetrics.complexityThreshold": 3）会导致大量误报，因为单个if x: ... elif y: ... else: ...就已到 4；建议设为6，对应“人脑短期记忆负荷临界点”
真正容易被忽略的一点：所有方案都依赖 AST 解析，只要函数体里混入 f-string 中未闭合的括号、f-strings 嵌套、或类型注解含语法糖（如 list[str] | None 在旧 Python 版本中），整个函数就会解析失败，直接跳过分析——所以看到 N/A，先检查语法是否合法，再查配置。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
