VSCode Python开发环境需安装官方扩展、配置解释器、启用代码检查工具、设置launch.json调试文件及工作区settings.json。具体包括：安装Microsoft Python扩展；通过命令面板选择Python解释器；安装并选择pylint或ruff作为linter；创建launch.json配置调试；在settings.json中设置解释器路径、保存格式化等。

如果您希望在VSCode中高效编写和调试Python代码，但当前环境缺少语法高亮、智能补全或断点调试支持，则可能是由于Python扩展未安装、解释器未正确配置或工作区设置不完整。以下是为Python配置VSCode开发环境的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装Python官方扩展

该扩展由Microsoft官方维护，提供语言服务、Jupyter支持、测试框架集成及格式化功能，是Python开发的基础依赖。

1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。

2、在搜索框中输入Python，找到发布者为Microsoft的官方扩展。

3、点击“安装”按钮，等待扩展下载并自动启用。

二、配置Python解释器路径

VSCode需明确识别当前项目使用的Python可执行文件位置，否则无法启动调试、无法解析第三方包路径、也无法触发类型检查。

1、按下Ctrl+Shift+P打开命令面板，输入并选择Python: Select Interpreter。

2、在弹出列表中选择已安装的Python版本，例如/usr/local/bin/python3或通过pyenv管理的版本路径。

3、若列表为空，点击Enter path...，手动输入解释器绝对路径。

三、安装并启用Pylint或Ruff作为代码检查工具

静态代码分析工具可实时检测语法错误、未使用变量、PEP 8风格违规等问题，提升代码质量与团队协作一致性。

1、在终端中运行命令：pip install pylint 或 pip install ruff。

2、回到VSCode，按下Ctrl+Shift+P，输入并选择Python: Select Linter。

3、从选项中选择pylint或ruff，完成启用。

四、配置launch.json启动调试配置

调试配置文件定义了程序运行方式、参数传递、环境变量注入等关键行为，是实现断点、变量监视和异常捕获的前提。

1、在项目根目录下，打开运行和调试视图（Ctrl+Shift+D），点击create a launch.json file链接。

2、选择环境为Python File，自动生成.vscode/launch.json文件。

3、在configurations数组中，确认"module": "python"字段存在，并将"justMyCode"设为true以聚焦用户代码。

五、设置工作区级别的settings.json

工作区配置可覆盖全局设置，确保团队成员在相同项目中获得一致的编辑体验，包括自动保存、格式化器绑定和括号匹配行为。

1、在VSCode中，依次点击File → Preferences → Settings（或Cmd+,）。

2、点击右上角Open Settings (JSON)图标，进入settings.json编辑界面。

3、添加以下关键项："python.defaultInterpreterPath"、"editor.formatOnSave"、"python.formatting.provider"（设为black或autopep8）。