需安装Python扩展、配置解释器、启用Pylint/Ruff检查、设置launch.json调试、配置Black/autopep8格式化。
如果您希望在VSCode中高效进行Python开发，但当前环境缺少调试支持、语法高亮异常或无法识别虚拟环境，则可能是由于扩展未安装、解释器未正确配置或工作区设置缺失。以下是实现完美Python开发环境的配置步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心扩展
VSCode本身不内置Python支持，需通过官方扩展提供语言服务、调试器和代码分析能力。
1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
立即学习“Python免费学习笔记（深入）”；
2、在搜索框中输入Python，找到由Microsoft发布的官方扩展（ID为ms-python.python）。
3、点击“安装”按钮，等待扩展下载并启用。
4、安装完成后，重启VSCode以确保所有语言服务器组件加载完毕。
二、配置Python解释器路径
VSCode需明确指定使用的Python可执行文件，否则无法运行、调试或提供类型提示。
1、打开一个Python项目文件夹（即包含.py文件的目录）。
2、按下Ctrl+Shift+P调出命令面板，输入并选择Python: Select Interpreter。
3、在弹出列表中选择系统Python、venv虚拟环境中的python或conda环境路径。
4、确认后，VSCode会在工作区根目录生成.vscode/settings.json并写入python.defaultInterpreterPath字段。
三、启用Pylint或Ruff作为代码检查工具
静态代码分析可实时发现潜在错误、风格违规与未使用变量，提升代码质量。
1、在终端中执行pip install pylint（或pip install ruff）。
2、打开命令面板，输入并选择Python: Select Linter。
3、从列表中选择Pylint或Ruff，按提示完成初始化配置。
4、VSCode将自动在保存时触发检查，并在问题面板中显示结果。
四、配置launch.json实现断点调试
调试配置文件定义了启动方式、参数及环境变量，是精准定位逻辑错误的基础。
1、确保已配置好Python解释器。
2、点击运行侧边栏，选择创建 launch.json 文件，然后选择Python环境。
3、在生成的.vscode/launch.json中，确认configurations数组至少含一项"console": "integratedTerminal"。
4、在Python文件中点击行号左侧设置断点，按F5启动调试会话。
五、设置格式化工具为Black或autopep8
统一代码风格可降低协作成本，VSCode支持保存时自动格式化。
1、在终端中执行pip install black（或pip install autopep8）。
2、打开命令面板，输入并选择Python: Select Formatter。
3、选择Black或autopep8，VSCode将自动修改settings.json中python.formatting.provider项。
4、开启保存格式化：在设置中搜索format on save，勾选Editor: Format On Save。
