前期准备

安装 VSCode 编辑器
从 VSCode 官网 下载并安装，支持 Windows、macOS 和 Linux 系统。安装过程默认选项即可。

安装 Python 解释器
推荐 Python 3.8 及以上版本，从 Python 官网 下载官方安装包。注意勾选 Add Python to PATH（Windows）或通过终端验证安装（macOS/Linux）。

验证 Python 安装
打开终端或命令行，输入以下命令确认安装成功：

python --version
# 或 Python 3.x 环境下
python3 --version

 

核心配置

安装 Python 扩展
在 VSCode 扩展市场搜索 Python（Microsoft 官方发布），安装后会自动集成 Pylint（代码检查）和 Debugger（调试工具）。

配置 Python 解释器

1. 打开一个 Python 文件（.py 后缀）或新建文件并保存为 .py 格式。
2. 点击右下角显示的 Python 版本（或按 Ctrl+Shift+P 输入 Python: Select Interpreter）。
3. 选择已安装的 Python 解释器路径（通常为 /usr/local/bin/python3 或 C:\PythonXX\python.exe）。

测试运行代码
创建 test.py 文件，输入以下内容并保存：

print("Hello, VSCode!")

 

点击右上角的 运行 按钮（绿色三角图标），确认终端输出结果。

终端优化

解决中文乱码（Windows）
在 VSCode 设置（Ctrl+,）中搜索 Terminal Integrated Font Family，添加 "Consolas", "Courier New" 或支持中文的字体。

激活虚拟环境
在终端中运行虚拟环境激活命令：

# Windows
.\venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

 

调试配置

配置调试环境

1. 打开调试面板（左侧栏图标或 Ctrl+Shift+D）。
2. 点击 创建 launch.json 文件，选择 Python File 模板。
3. 修改配置以适配项目路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        }
    ]
}

 

插件推荐

• Pylance: 增强代码补全和类型检查。
• Black Formatter: 自动格式化代码（需在设置中启用 Editor: Format On Save）。
• Jupyter: 支持交互式编程（适用于数据分析）。
• Python Docstring Generator: 快速生成函数注释。

虚拟环境管理

创建虚拟环境
在项目目录下运行：

python -m venv venv

 

在 VSCode 中切换虚拟环境

1. 按 Ctrl+Shift+P 输入 Python: Select Interpreter。
2. 选择虚拟环境中的 python 路径（如 ./venv/bin/python）。

常见问题

解释器未识别

• 检查 Python 是否已添加到系统 PATH。
• 重启 VSCode 或手动指定解释器路径。

依赖包缺失

• 在终端中通过 pip 安装缺失包：

pip install 包名

 

• 确认虚拟环境已激活。

智能提示失效

• 确保 Pylance 插件已启用。
• 在设置中开启类型检查：

"python.analysis.typeCheckingMode": "basic"

快捷键参考

• 运行代码: F5（调试）或 Ctrl+F5（直接运行）。
• 格式化代码: Shift+Alt+F。
• 打开终端: Ctrl+`` 。
• 快速跳转定义: F12。