Ubuntu 环境下使用 VS Code 高效开发 Python 项目：从零开始的超详细指南**

文章描述： 本文详细介绍了如何在 Ubuntu 系统下，配置并使用 Visual Studio Code (VS Code) 作为 Python 开发环境，从环境准备、VS Code 安装与配置，到 Python 开发核心技巧、调试与运行，再到常用插件推荐和最佳实践，为 Python 开发者提供一套完整、高效的入门到进阶教程，助你在 Ubuntu 上畅享 Python 编程乐趣。

Ubuntu 环境下使用 VS Code 高效开发 Python 项目：从零开始的超详细指南

在当今的软件开发领域，Python 以其简洁的语法、强大的库支持和广泛的应用场景（如数据分析、人工智能、Web 开发、自动化脚本等），成为了最受欢迎的编程语言之一，而 Ubuntu 作为最受欢迎的 Linux 发行版之一，为开发者提供了稳定、开源的开发环境，Visual Studio Code（简称 VS Code）则是微软推出的一款免费、开源、跨平台的轻量级但功能强大的代码编辑器，通过丰富的插件生态,可以胜任各种语言的开发工作。

将 Ubuntu、VS Code 和 Python 三者结合，无疑为 Python 开发者打造了一个高效、灵活且强大的开发环境，本文将手把手带你从零开始，搭建这个黄金组合，并深入讲解如何高效使用它们进行 Python 项目开发。

环境准备：Ubuntu 系统与 Python 的初步接触

在开始之前，请确保你已经安装好了 Ubuntu 系统（推荐使用 LTS 长期支持版本，如 20.04 或 22.04），大多数 Ubuntu 版本默认已经安装了 Python，但为了确保版本的一致性和完整性,我们建议进行以下检查和安装。

检查 Python 是否已安装

打开终端（Terminal），你可以通过以下命令检查 Python 是否已安装以及其版本：

python3 --version

或者

python --version

（注意：在 Ubuntu 中，python3 命令指向 Python 3.x，而 python 命令可能未安装或指向旧版 Python 2.x，推荐使用 python3。）

如果看到类似 Python 3.8.10 的输出，则表示 Python 3 已安装，如果未安装或版本过低,可以使用以下命令进行安装或更新。

安装/更新 Python 3

# 更新包列表
sudo apt update
# 安装 Python 3 和 pip（Python 包管理器）
sudo apt install python3 python3-pip python3-venv

python3-pip 是用于安装 Python 第三方库的工具，python3-venv 则用于创建虚拟环境，这是 Python 项目开发的最佳实践之一。

配置 Python 虚拟环境（强烈推荐）

虚拟环境可以为每个 Python 项目创建一个独立、隔离的运行环境,避免不同项目之间的库版本冲突。

# 创建一个名为 my_project_env 的虚拟环境
python3 -m venv my_project_env
# 激活虚拟环境
source my_project_env/bin/activate
# 激活后，终端提示符前会出现 (my_project_env)，表示虚拟环境已激活
# 在虚拟环境中，我们使用 pip 安装库，默认会安装到当前环境
# pip install numpy pandas
# 退出虚拟环境
deactivate

小贴士： 始终在虚拟环境中进行 Python 项目开发,这会让你的项目更加整洁和易于管理。

安装与配置 Visual Studio Code (VS Code)

VS Code 本身不是 Python IDE，但通过其强大的 Python 扩展，可以媲美专业 IDE。

下载并安装 VS Code

• 访问 VS Code 官方下载页面：https://code.visualstudio.com/
• 选择适用于 Linux (x64) 的 .deb 安装包（适用于 Ubuntu 及其衍生版）。
• 下载完成后，在文件管理器中找到下载的 .deb 文件，双击安装,或使用命令行：

# 进入下载目录（假设文件名为 code_1.75.0-1681119205_amd64.deb）
cd ~/Downloads
sudo dpkg -i code_1.75.0-1681119205_amd64.deb
# 如果遇到依赖问题，执行以下命令修复
sudo apt install -f

启动 VS Code

安装完成后，你可以在应用程序菜单中找到 VS Code 并启动,或在终端中输入：

code

安装 Python 扩展

VS Code 的强大之处在于其扩展生态。

1. 启动 VS Code 后，点击左侧活动栏中的“扩展”图标（或按 Ctrl+Shift+X）。
2. 在搜索框中输入 Python。
3. 找到由 Microsoft 发布的 Python 扩展（通常排名第一，下载量最高），点击“安装”。

Python 扩展的功能：

• 语法高亮
• 智能代码补全（IntelliSense）
• 代码格式化
• 错误检查和实时提示
• 调试支持
• 测试支持
• Jupyter Notebook 支持

配置 VS Code 使用 Python 解释器

为了让 VS Code 正确识别并使用我们安装的 Python 解释器（特别是虚拟环境中的解释器）,需要进行以下配置：

1. 打开一个 Python 项目文件夹，或创建一个新的文件夹并在 VS Code 中打开。
2. 按 Ctrl+Shift+P 打开命令面板。
3. 输入并选择 Python: Select Interpreter。
4. 在弹出的列表中，选择你想要使用的 Python 解释器，如果你之前创建了虚拟环境并激活了它，这里应该能看到虚拟环境中的 Python 解释器路径（如 /home/your_user/my_project_env/bin/python3）。
5. 如果你没有看到虚拟环境的解释器，可以点击“+”号手动添加路径。

选择正确的解释器至关重要，这确保了你的代码在正确的环境中运行，VS Code 的代码提示、调试等功能都能正常工作。

VS Code Python 开发核心技巧

配置好环境后，我们来看看如何在 VS Code 中高效地进行 Python 开发。

创建和运行 Python 脚本

• 在 VS Code 中，右键点击资源管理器中的空白处，选择“新建文件”，命名为 hello.py。
• 输入以下代码：

  print("Hello, Ubuntu VS Code Python!")
  a = 10
  b = 20
  print(f"The sum of {a} and {b} is {a + b}")

• 保存文件（Ctrl+S）。
• 运行脚本：
  • 在终端中（VS Code 底部可打开集成终端），确保虚拟环境已激活，然后输入 python hello.py。
  • 在代码编辑器中，右键点击，选择“在终端中运行 Python 文件”（或按 Ctrl+Shift+P 输入 Python: Run Python File in Terminal）。
  • 使用 VS Code 的运行按钮（编辑器右上角的播放按钮）。

代码补全与智能提示

安装了 Python 扩展后，VS Code 会提供强大的智能代码补全功能，当你输入代码时，VS Code 会根据上下文提示可用的变量、函数、类等。

• 触发补全： Ctrl+Space 或直接输入。
• 参数信息： 输入函数名后跟 ,会显示函数的参数列表和文档字符串。

代码格式化

整洁的代码风格有助于阅读和维护，VS Code 支持多种代码格式化工具，如 autopep8、black、yapf 等。

• 安装格式化工具： 在激活的虚拟环境中运行：

  pip install autopep8 black

• 配置格式化工具：
  1. 按 Ctrl+Shift+P，输入 Settings，选择“首选项：打开设置（JSON）”。
  2. 在打开的 settings.json 文件中，添加或修改以下配置：

     {
         "python.formatting.provider": "autopep8", // 或 "black"
         "python.formatting.autopep8.args": ["--in-place", "--aggressive", "--aggressive"],
         "python.formatting.black.args": ["--line-length", "88"]
     }

• 格式化代码： 选中要格式化的代码，右键选择“格式化文档”，或按 Shift+Alt+F（Windows/Linux）或 `Shift+Option