单独安装 Python 扩展不够用，因其仅为调度器，需额外安装 Pylance、Black 等扩展才能启用 linting、格式化、类型检查等功能；推荐安装 Python Extension Pack 并手动选择解释器。
Python 扩展本身不包含所有开发所需工具，必须额外安装配套扩展才能启用 linting、格式化、类型检查等核心功能。只装 Python 扩展，你会遇到代码无报错提示、保存不自动格式化、跳转定义失效等问题。
为什么单独安装 Python 扩展不够用？
Microsoft 官方的 Python 扩展（ID: ms-python.python）本质是“调度器”：它提供基础语言服务入口，但具体能力由其他扩展实现。比如：
-
pylint、flake8或pyright负责代码检查（linting） -
black、autopep8或yapf负责格式化（formatting） -
Pylance提供 IntelliSense 补全和类型推导（默认启用，但需单独安装）
VS Code 不会自动帮你装这些依赖——它只在你首次触发对应功能时弹窗提示，而很多人直接点了“稍后提醒”，结果就一直没配。
推荐一次性安装的工具集：Python Extension Pack
这是微软官方打包的扩展合集，包含 Python、Pylance、Jupyter、Python Test Explorer 和 Black Formatter 等 5 个高频组件，省去逐个搜索安装的麻烦。
- 打开扩展面板（
Ctrl+Shift+X），搜索Python Extension Pack - 认准发布者为
Microsoft，安装后无需重启，但建议重载窗口（Ctrl+Shift+P→ 输入Developer: Reload Window） - 安装完成后，
Pylance会自动启用；若状态栏右下角显示Pyright或Pylance，说明类型支持已就位
哪些组件可以不装？看实际需求取舍
Python Extension Pack 里有些组件对轻量脚本开发者是冗余的：
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 如果你不用 Jupyter Notebook，可禁用
Jupyter扩展（右键扩展 → “禁用”），避免启动变慢 - 如果项目已用
pylint，就不必再开Python扩展内置的flake8检查（关掉python.linting.flake8Enabled） -
Python Test Explorer只在项目含pytest或unittest时才有用，否则可卸载
禁用或卸载后，记得检查 settings.json 中是否残留相关配置项，比如 python.testing.pytestArgs，残留会导致启动时反复报错。
安装后必须做的三件事
装完不是终点，以下操作直接影响编码体验：
- 按
Ctrl+Shift+P输入Python: Select Interpreter，手动选中你的 Python 解释器路径（尤其是虚拟环境） - 新建一个
.py文件，输入import os; os.，看是否弹出方法补全——没有则说明Pylance未生效 - 保存文件时观察右下角是否出现“Formatting with black…”提示，没有则检查
python.formatting.provider是否设为black
真正容易被忽略的是解释器路径绑定：即使系统有多个 Python 版本，VS Code 也不会自动猜你用哪个。一旦选错，import 报错、第三方包找不到、调试器断点失效，全都会发生。
