> 技术文档 > 在 VS Code 中配置 Python 开发环境:从零开始完整指南_visual studio code怎么从0开始运行python

在 VS Code 中配置 Python 开发环境:从零开始完整指南_visual studio code怎么从0开始运行python


在 VS Code 中配置 Python 开发环境:从零开始完整指南

📌 摘要
VS Code 是当前最流行的代码编辑器之一,结合 Python 可以打造高效的开发环境。本文将详细介绍如何从零开始配置 VS Code,使其完美支持 Python 开发,并解决常见问题。


📝 目录

  1. 为什么选择 VS Code 进行 Python 开发?

  2. 安装 Python 和 VS Code

  3. 配置 VS Code 运行 Python

  4. 运行 Python 代码的 3 种方式

  5. 优化 Python 开发体验

  6. 常见问题及解决方案

  7. 总结


🔍 1. 为什么选择 VS Code 进行 Python 开发?

VS Code(Visual Studio Code)是一款免费、开源、跨平台的代码编辑器,具有以下优势:
✅ 轻量级:启动快,占用资源少
✅ 强大的扩展生态:支持 Python、Jupyter、Git 等
✅ 智能代码补全(Pylance、IntelliSense)
✅ 调试功能强大(断点调试、变量监视)
✅ 支持 Jupyter Notebook(数据科学友好)


⚙️ 2. 安装 Python 和 VS Code

(1)安装 Python

  1. 前往 Python 官网 下载最新版本。

  2. 安装时务必勾选 Add Python to PATH(否则需手动配置环境变量)。

  3. 验证安装:

    bash

    python --versionpip --version

(2)安装 VS Code

  1. 下载 VS Code 并安装。

  2. 打开后安装 Python 扩展(搜索 Python,由 Microsoft 提供)。


🔧 3. 配置 VS Code 运行 Python

(1)选择 Python 解释器

  1. 打开 VS Code,按 Ctrl+Shift+P(Mac:Cmd+Shift+P)。

  2. 输入 Python: Select Interpreter,选择你的 Python 版本(如 Python 3.11.x)。

✅ 验证配置

  • 终端输入 python,应进入 Python 交互模式。

(2)推荐安装的扩展

扩展名 功能 Python 官方 Python 支持 Pylance 更强大的代码补全 Jupyter 运行 .ipynb 文件 Code Runner 快速运行代码

🚀 4. 运行 Python 代码的 3 种方式

方法 1:直接运行(F5 调试模式)

  1. 打开 .py 文件,按 F5 或点击右上角 ▶️ 运行

  2. 输出显示在 调试控制台(Debug Console)。示例运行:

方法 2:终端手动运行

  1. 按 Ctrl+` 打开终端。

  2. 输入:

    bash

    python 文件名.py

方法 3:Jupyter Notebook(交互式编程)

  1. 安装 Jupyter:

    bash

    pip install jupyter
  2. 新建 .ipynb 文件,选择 Jupyter 内核 运行代码块。


✨ 5. 优化 Python 开发体验

(1)代码自动格式化

  1. 安装 autopep8

    bash

    pip install autopep8
  2. 在 VS Code 设置(Ctrl+,)中启用:

    json

    \"editor.formatOnSave\": true,\"python.formatting.provider\": \"autopep8\"

(2)调试 Python 代码

  • 设置断点(点击行号左侧),按 F5 进入调试模式。

  • 可查看变量、调用堆栈等信息。

(3)使用虚拟环境

bash

python -m venv venvsource venv/bin/activate # Linux/Macvenv\\Scripts\\activate # Windows

❌ 6. 常见问题及解决方案

问题 解决方法 VS Code 找不到 Python 检查 PATH,重新选择解释器 运行代码无输出 确保文件已保存(.py 后缀) Jupyter 无法启动 运行 pip install jupyter 代码补全不工作 安装 Pylance 扩展

🎯 7. 总结

✅ 安装 Python 并添加到 PATH
✅ 安装 VS Code + Python 扩展
✅ 选择正确的 Python 解释器
✅ 使用 F5、终端或 Jupyter 运行代码
✅ 优化:格式化、调试、虚拟环境

现在,你的 VS Code 已经完美支持 Python 开发! 🎉

📢 互动:你在配置 Python 环境时遇到过什么问题?欢迎在评论区讨论!