广告

Ubuntu 上安装 Python3 与环境配置全流程指南(从零基础到上手开发)

1. 准备工作与系统版本确认

为何选择 Ubuntu 与版本要点

在开发人员的日常工作中,Ubuntu 提供稳定的长期支持版本,尤其推荐使用 LTS 版本,如 22.04 LTS。使用稳定的系统可以减少环境问题的干扰,确保与大量开源工具的兼容性。

本指南以 22.04 LTS 为例,解释如何在 从零基础 的前提下完成 Python3 的安装与环境配置,确保后续上手开发过程高效流畅。

在继续操作前请确保 网络连接可用,并且系统索引可达。执行下面的命令可以检查网络和更新源状态:

ping -c 3 pypi.org >/dev/null && echo "网络通畅" || echo "网络异常,请排查"

更新系统包索引可以确保获取到最新的软件版本,减少后续安装问题。

sudo apt update
sudo apt upgrade -y

2. Ubuntu 上安装 Python3 的基本流程

使用系统自带的 Python3 版本

大多数 Ubuntu 发行版本都自带了 Python3,直接安装相关包即可快速进入开发环境,推荐安装 python3、python3-venv、python3-pip 来支持虚拟环境和包管理。

sudo apt update
sudo apt install -y python3 python3-venv python3-pip

安装完成后,验证版本号和可用的包管理器版本非常关键,以确保后续步骤的正确执行。

python3 --version
pip3 --version

验证安装结果

系统自带的版本通常已经足够入门开发,但若需要更高版本或多版本并存,后续可使用 pyenv 等工具进行管理。

如果需要更高版本的 Python

如果需要远超系统默认版本,可以考虑使用 pyenv 实现多版本并存,或从源码自行编译。下面给出两种常用路径。

# 使用 pyenv 管理多版本
curl https://pyenv.run | bash
# 需要将下列内容添加到 shell 配置文件中,例如 .bashrc
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv virtualenv-init -)"

3. 环境管理工具:虚拟环境与包管理

使用 venv 建立虚拟环境

在实际开发中,虚拟环境能帮助你隔离项目依赖,避免全局包冲突。通过 venv 可以快速创建一个干净的环境。

python3 -m venv myenv
# 激活(Bash / Zsh)
source myenv/bin/activate

激活后,所有安装都局限在当前虚拟环境中,这对重现性和部署都很重要。

使用 pyenv 管理多版 Python

若需要在同一系统中切换不同的 Python 版本,pyenv 提供了简便的方法来安装与切换版本。

pyenv install 3.11.5
pyenv global 3.11.5

在特定项目中,你可以使用 local 命令锁定版本,以确保团队成员使用相同的环境。

包管理工具:pip、pipenv、poetry

Pip 是最基本的包管理工具,尽量升级至最新版本以获得安全与性能改进。

python3 -m ensurepip --upgrade
python3 -m pip install --upgrade pip

若需要更严格的依赖管理,可以尝试 pipxpoetrypipenv,帮助你为项目创建锁文件和隔离环境。

4. 开发工具与环境配置

安装常用开发工具与构建依赖

编译扩展或安装部分组合包时,构建工具与开发头文件是必需的。系统中常用的依赖包括 build-essential、libssl-dev、libffi-dev、python3-dev 等。

sudo apt update
sudo apt install -y build-essential libssl-dev libffi-dev python3-dev

国内镜像源与 pip 镜像配置

为了提升下载速度,可以将 apt 与 pip 指向国内镜像源。设置后续安装更稳定,尤其是在构建阶段。

# 这是示例,实际请替换为可用的镜像源
sudo sed -i 's|http://.*.ubuntu.com|http://cn.archive.ubuntu.com|g' /etc/apt/sources.list
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

编辑器与 IDE 的基本配置

常用的编辑器选择包括 VS CodePyCharm,并在其中安装 Python 扩展/插件,以获得代码补全、调试和虚拟环境感知能力。

code --version

5. 从零基础到上手开发:写一个简单的 Python 程序

创建练习目录与文件

在工作区中创建一个简单的项目目录,hello.py 是入门样例,便于理解输入输出与基础语法。

# hello.py
print("Hello, Ubuntu + Python3!")

运行程序并验证输出

在当前激活的虚拟环境中,执行程序并确认输出,输出应为 Hello, Ubuntu + Python3!

python3 hello.py

调试基础与日志输出

为追踪运行情况,可以引入 logging,并设置基本日志等级。

import logging
logging.basicConfig(level=logging.INFO)
logging.info("程序启动")

6. 在 Ubuntu 上持续开发的日常优化

定时更新与备份策略

保持系统与依赖的新鲜度对于安全与稳定性非常重要。建议设置 自动更新 与定期备份。

Ubuntu 上安装 Python3 与环境配置全流程指南(从零基础到上手开发)

sudo crontab -e
# 每日凌晨 2 点执行备份脚本
0 2 * * * /path/to/backup.sh

虚拟环境的日常维护

在长期项目中,定期维护依赖清单是关键。确保 requirements.txt 能够准确反映依赖版本。

pip install -r requirements.txt

广告

操作系统标签