1. 使用 pyenv 管理多个 Python 版本：避免系统 Python 版本冲突，轻松切换和安装不同版本的 Python。
2. 使用 venv 创建虚拟环境：为每个项目隔离依赖，防止包版本冲突。
3. 使用 pip + pipx 管理包：pip 用于项目依赖，pipx 用于安装全局命令行工具。
4. 使用 VS Code 作为 IDE：免费、强大、高度可定制，是 Python 开发的绝佳选择。

总览步骤

1. 系统更新：确保你的 Ubuntu 系统是最新的。
2. 安装必要工具：安装 git, make, build-essential 等编译 Python 所需的依赖。
3. 安装 pyenv：安装 Python 版本管理器。
4. 使用 pyenv 安装 Python：安装你需要的 Python 版本（如 3.10）。
5. 配置 Shell：让 Shell 识别 pyenv。
6. 创建虚拟环境：为你的项目创建一个隔离的环境。
7. 安装 VS Code：安装并配置 Python 开发工具。
8. 可选：使用 pipx：安装全局命令行工具。

详细步骤

第 1 步：更新系统

打开终端（快捷键 Ctrl+Alt+T），更新你的软件包列表和已安装的包。

sudo apt update
sudo apt upgrade -y

第 2 步：安装编译 Python 所需的依赖

pyenv 需要从源码编译安装 Python，因此需要一些基础的编译工具。

sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

提示：如果你不确定，可以直接复制粘贴整行命令执行。

第 3 步：安装 pyenv

pyenv 是一个让你轻松在多个 Python 版本之间切换的神奇工具。

curl https://pyenv.run | bash

这个命令会自动下载并执行 pyenv 的安装脚本。

第 4 步：配置 Shell

为了让 Shell 能够找到 pyenv 命令，你需要修改你的 Shell 配置文件，根据你使用的 Shell，选择以下对应的命令：

• 如果你使用的是 Bash (Ubuntu 默认 Shell):

  echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
  echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
  echo 'eval "$(pyenv init -)"' >> ~/.bashrc

• 如果你使用的是 Zsh:

  echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
  echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
  echo 'eval "$(pyenv init -)"' >> ~/.zshrc

重要： 配置完成后，重新打开你的终端，或者运行 source ~/.bashrc (或 source ~/.zshrc) 来让配置生效。

验证 pyenv 是否安装成功：

pyenv --version
# 应该输出类似 pyenv 2.3.15 这样的信息

第 5 步：使用 pyenv 安装 Python

你可以使用 pyenv 安装你想要的 Python 版本，我们以安装 Python 3.10.13 为例（这是一个稳定且广泛使用的版本）。

1. 查看可安装的 Python 版本：

   pyenv install --list

   你会看到一个长长的列表,包含所有可用的 Python 版本。

2. 安装指定版本：

   pyenv install 3.10.13

   这一步需要一些时间,因为它正在从源码编译 Python，你可以去喝杯咖啡 ☕️。

3. 设置全局 Python 版本： 安装后，你可以将这个版本设置为你的默认 Python 版本。

   pyenv global 3.10.13

4. 验证 Python 版本： 检查现在使用的 Python 版本是否正确。

   python --version
   # 应该输出 Python 3.10.13

   pip 命令也应该可用了。

   pip --version

第 6 步：为项目创建虚拟环境

虚拟环境是 Python 开发的核心，它能确保每个项目的依赖互不干扰。

1. 创建项目目录：

   mkdir my_python_project
   cd my_python_project

2. 创建虚拟环境： 在项目目录下，使用 python -m venv 命令创建一个名为 .venv 的虚拟环境文件夹。

   python -m venv .venv

   提示：.venv 是一个常见的命名约定，可以防止它被 git 等工具忽略。

3. 激活虚拟环境： 激活后，你的终端提示符前面会出现 (.venv)，表示你已处于虚拟环境中。

   source .venv/bin/activate

   当你运行 python --version 和 pip --version 时，它们都会指向虚拟环境中的版本，与你的全局版本隔离。

4. 安装项目依赖： 在激活的虚拟环境中，使用 pip 安装你需要的包，安装 requests 和 numpy。

   pip install requests numpy

5. 退出虚拟环境： 当你完成工作后，可以随时退出虚拟环境。

   deactivate

第 7 步：安装和配置 VS Code

VS Code 是目前最受欢迎的代码编辑器之一，其 Python 扩展功能非常强大。

1. 安装 VS Code： 最简单的方式是使用官方的 .deb 包。

   wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
   sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
   echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code/ stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
   sudo apt update
   sudo apt install -y code

2. 安装 Python 扩展： 打开 VS Code (code)，点击左侧活动栏的 扩展 图标（或按 Ctrl+Shift+X）。 在搜索框中输入 Python，由 Microsoft 发布的那个扩展，点击 安装。

3. 配置 VS Code 使用虚拟环境：

   • 在 VS Code 中打开你的项目文件夹 (File -> Open Folder...)。
   • VS Code 会自动检测到项目中的 .venv 文件夹，并在右下角弹出一个提示，询问是否选择该解释器，点击 "选择解释器"。
   • 如果没有自动检测,可以按 Ctrl+Shift+P 打开命令面板，输入 Python: Select Interpreter，然后在列表中选择 .venv/bin/python。
   • 选择后,VS Code 窗口右下角会显示选中的 Python 版本，并且所有代码提示、Linting、调试功能都会基于这个虚拟环境。

4. 享受编码！ 现在你可以创建 .py 文件，VS Code 会提供语法高亮、代码自动补全、错误检查等强大功能。

第 8 步（可选）：使用 pipx 管理全局工具

有些 Python 包（如 black, httpie, jupyter）是作为命令行工具使用的，你希望它们在全局可用，但又不想污染你的系统 Python 或某个项目的虚拟环境。pipx 就是为此而生的。

1. 安装 pipx：

   pip install pipx
   pipx ensurepath

   ensurepath 会提示你将 ~/.local/bin 添加到 PATH 中，根据提示，将命令添加到你的 ~/.bashrc 或 ~/.zshrc，然后重新加载配置或重启终端。

2. 使用 pipx 安装工具： 安装代码格式化工具 black：

   pipx install black

   你可以在任何地方直接使用 black 命令，它被安装在一个独立、隔离的环境中。

总结与最佳实践

工作流建议：

1. 新项目开始时,用 pyenv 确保你有一个合适的 Python 版本。
2. 进入项目目录,用 python -m venv .venv 创建并激活虚拟环境。
3. 在 VS Code 中打开项目，让它自动选择虚拟环境的解释器。
4. 用 pip 安装项目所需依赖。
5. 用 pipx 安装那些你想在全局使用的工具。

遵循这个流程,你将拥有一个干净、灵活且高效的 Python 开发环境，能够轻松应对各种项目需求，祝你编码愉快！