如何在Ubuntu服务器上安装pip和Python常用库？

2026-09-25 09:05:25 分类：云计算

在 Ubuntu 服务器上安装 pip 和 Python 常用库

一、系统环境确认

# 查看 Ubuntu 版本
lsb_release -a

# 查看已安装的 Python 版本
python3 --version
pip3 --version   # 如果已安装

注意：Ubuntu 18.04+ 默认使用 python3，不再提供 python2。以下操作均基于 Python 3。

二、安装 pip

方法 1：通过 apt 安装（推荐，最简单）

# 更新软件包索引
sudo apt update

# 安装 python3-pip
sudo apt install -y python3-pip

# 验证安装
pip3 --version

方法 2：使用 get-pip.py（适用于没有预装 pip 的情况）

# 安装 curl（如果未安装）
sudo apt install -y curl

# 下载并运行 get-pip.py
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

# 执行安装
sudo python3 get-pip.py

# 验证
pip3 --version

方法 3：使用 ensurepip 模块

sudo apt install -y python3-venv

# 创建虚拟环境时会自动包含 pip
python3 -m venv myenv
source myenv/bin/activate
pip --version

三、升级 pip 本身

# 升级 pip 到最新版本
pip3 install --upgrade pip

# 或者使用 get-pip.py 强制升级
sudo python3 get-pip.py --force-reinstall

四、安装 Python 常用库

1. 基础开发库

# 科学计算与数据分析
pip3 install numpy pandas scipy matplotlib seaborn

# Web 开发
pip3 install flask django fastapi uvicorn gunicorn

# 数据库
pip3 install sqlalchemy psycopg2-binary pymysql mysqlclient

# API / HTTP
pip3 install requests httpx beautifulsoup4 lxml

# 机器学习 / AI
pip3 install scikit-learn tensorflow pytorch transformers

# 自动化 / 脚本
pip3 install celery redis pymongo

# 测试
pip3 install pytest coverage pylint black isort flake8

# 其他实用工具
pip3 install python-dotenv jinja2 cryptography paramiko fabric

2. 使用 requirements.txt 批量安装（推荐）

# requirements.txt 示例
numpy==1.24.3
pandas==2.0.2
flask==2.3.2
requests==2.31.0
sqlalchemy==2.0.15
pytest==7.4.0
black==23.3.0
# 批量安装
pip3 install -r requirements.txt

五、最佳实践：使用虚拟环境 ⭐

强烈建议不要在系统全局安装 Python 包，而是使用虚拟环境隔离项目依赖。

# 1. 安装 venv 模块
sudo apt install -y python3-venv

# 2. 为项目创建虚拟环境
mkdir ~/myproject
cd ~/myproject
python3 -m venv venv

# 3. 激活虚拟环境
source venv/bin/activate

# 此时提示符会变为 (venv) $，表示已进入虚拟环境

# 4. 在虚拟环境中安装 pip 和库
pip install --upgrade pip
pip install numpy pandas flask

# 5. 导出依赖（方便部署和复现）
pip freeze > requirements.txt

# 6. 退出虚拟环境
deactivate

在服务器上部署时使用虚拟环境

# SSH 登录后进入项目目录
cd ~/myproject
source venv/bin/activate

# 安装所有依赖
pip install -r requirements.txt

# 启动应用
gunicorn main:app --bind 0.0.0.0:8000

六、常见问题与解决

问题 1：权限错误 Permission denied

# ❌ 不要使用 sudo pip install（会破坏系统包管理）
# ✅ 正确做法：使用虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install <package>

问题 2：编译依赖缺失（某些库需要 C 编译器）

# 安装构建工具和头文件
sudo apt install -y build-essential libffi-dev libssl-dev 
    libxml2-dev libxslt1-dev zlib1g-dev pkg-config

问题 3：pip 缓存导致安装失败

# 清除缓存后重试
pip3 cache purge
pip3 install --no-cache-dir <package>

问题 4：指定国内镜像源提速下载

# 临时使用清华镜像
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy

# 永久配置（推荐）
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip3 config set global.trusted-host pypi.tuna.tsinghua.edu.cn

# 其他常用镜像
# 阿里云: https://mirrors.aliyun.com/pypi/simple/
# 豆瓣:   https://pypi.douban.com/simple/

问题 5：查看已安装的包

pip3 list              # 列出所有包
pip3 show <package>    # 查看某个包的详细信息
pip3 list --outdated   # 查看可更新的包

七、完整安装流程总结

┌─────────────────────────────────┐
│  1. 更新系统                    │
│     sudo apt update             │
├─────────────────────────────────┤
│  2. 安装基础工具                │
│     sudo apt install -y         │
│       python3 python3-pip       │
│       python3-venv build-essential│
├─────────────────────────────────┤
│  3. 创建虚拟环境                │
│     python3 -m venv venv        │
│     source venv/bin/activate    │
├─────────────────────────────────┤
│  4. 升级 pip                    │
│     pip install --upgrade pip   │
├─────────────────────────────────┤
│  5. 安装项目依赖                │
│     pip install -r requirements.txt│
├─────────────────────────────────┤
│  6. 验证                        │
│     python3 -c "import numpy;   │
│                  print(numpy.__version__)"│
└─────────────────────────────────┘

遵循以上步骤，即可在 Ubuntu 服务器上安全、规范地安装和管理 Python 及常用库。始终优先使用虚拟环境，避免污染系统 Python 环境。

相关推荐

云服务器