Ubuntu怎么配置Python?,ubuntu配置python环境怎么做
- 虚拟主机
- 2026-08-10
- 8
在Ubuntu上配置Python环境,核心思路是使用系统包管理器安装官方Python版本,再通过pyenv实现多版本管理,并搭配venv构建虚拟环境,从而实现项目依赖的完全隔离,这套方案兼顾了稳定性与灵活性,既满足系统级应用的需求,又支持开发者的版本切换需求,以下从版本选择、安装方式、环境管理、性能优化四个层次展开,每个环节都提供可直接执行的命令和独立见解。
选择合适的Python版本
Ubuntu 20.04/22.04默认自带Python 3.8或3.10,但很多新项目需要Python 3.11+。不建议直接覆盖系统Python,这可能导致系统工具(如apt)依赖异常,推荐的做法是:保留系统Python,另行安装一个或多个用户级Python版本。
- 查看当前系统Python版本:python3 --version
- 确定需求:如果是新项目,优先使用Python 3.11或3.12;如果是维护老项目,则根据项目要求选择。
- 版本选择原则:优先选择仍在安全支持期内的版本,例如Python 3.9及以上,避免使用EOL版本。
使用包管理器安装Python基础环境
对于大多数用户,通过apt安装是最快捷的方式:
sudo apt update sudo apt install python3 python3-pip python3-dev python3-venv
- python3-dev:包含Python头文件和静态库,编译C扩展时必需。
- python3-venv:内置的虚拟环境模块,Python 3.3+自带。
安装后验证:python3 --version
和 pip3 --version。
注意:apt仓库中的Python版本可能滞后,如需最新版,建议使用pyenv。

使用pyenv管理多版本
pyenv可以安装多个Python版本并全局切换,不影响系统Python。
安装pyenv
curl https://pyenv.run | bash
加入 ~/.bashrc(或~/.zshrc):
export PATH="$HOME/.pyenv/bin:$PATH" eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)"
重新加载配置:source ~/.bashrc
安装所需Python版本
pyenv install 3.12.0 pyenv install 3.10.13
设置全局或局部版本
- 全局:pyenv global 3.12.0
- 目录局部:pyenv local 3.10.13(在该目录下自动切换)
独立见解:pyenv的虚拟环境插件(pyenv-virtualenv)可以替代传统virtualenv,但更推荐使用Python内置的venv,因为它更轻量且无需额外依赖,pyenv主要负责版本切换,虚拟环境交给venv管理。
配置虚拟环境实现项目隔离
每个项目都应拥有独立的Python环境,避免依赖冲突。

使用venv创建虚拟环境
cd myproject python3 -m venv venv source venv/bin/activate
- 激活后,pip安装的包只影响当前环境。
- 使用deactivate退出。
配置pip国内镜像源(加速下载)
创建或编辑 ~/.pip/pip.conf:
[global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com
简米云、清华、中科大镜像均可,选择速度最快的即可。
安装常用开发工具
pip install ipython jedi flake8 black pytest
这些工具可以帮助提升编码效率和代码质量。
系统级优化与西西云经验案例
在生产环境中,配置Python环境还需要考虑性能与稳定性。西西云的云服务器默认采用Ubuntu 22.04 LTS,我们在此环境中积累了一套快速部署方案:

-
使用云服务器预装镜像:西西云提供“Python开发环境”镜像,预装了pyenv、Python 3.11、pip及常用工具,用户创建实例后即可直接使用,无需手动配置,这省去了反复安装依赖的麻烦,尤其适合快速搭建CI/CD流水线。
-
结合对象存储管理依赖包:对于大型项目,我们建议将项目依赖包打包压缩后上传至西西云对象存储,在部署时通过内网高速下载并解压到虚拟环境,显著减少pip install的时间,使用pip download -r requirements.txt生成离线包,再上传到对象存储,在服务器上通过pip install --no-index --find-links=./packages安装,速度提升5倍以上。
-
配置自动激活脚本:在西西云服务器上,我们在~/.bashrc中添加了自动检测项目目录下的venv并激活的脚本,避免每次登录手动source,具体实现:
经验总结:生产环境中最常见的Python配置问题是版本冲突和依赖安装失败,通过前文所述的pyenv + venv组合,配合国内镜像源,可以解决90%的问题,剩余10%需要关注系统库的缺失(如libssl-dev、libffi-dev),提前用apt安装即可。
常见问题问答
Q1:如何切换Python默认版本?
不需要修改系统默认的python3链接,而应使用pyenv的global或local命令。pyenv global 3.12.0会让当前用户的Python版本变为3.12,但系统Python保持不变,如果需要临时切换,直接使用pyenv shell 3.10.13。
Q2:为什么pip安装包时提示“外部管理环境”?
这是Ubuntu在Python 3.11+引入的保护机制,防止pip意外覆盖系统包,解决方案是:始终在虚拟环境中使用pip,或者在全局下使用pip install --break-system-packages(不推荐),正确做法是创建一个虚拟环境,然后在该环境中安装。
互动
你在Ubuntu配置Python时遇到过哪些奇怪的问题?是依赖冲突还是版本切换不顺畅?欢迎在评论区分享你的经历,我们一起探讨更高效的解决方案,如果本文对你有帮助,不妨收藏备用,下次配置时直接参考。