Ubuntu24.02安装python库以及部署python项目

天下不喵2025-11-12 10:13

一. 问题引入

在服务器的系统镜像换到最新的Ubuntu24.02后，原先的python安装机制发生了改变，之前的pip安装的方式变得不可用。

二. 问题及解决记录

1. python指令不可用

执行python指令报错:

bash 复制代码

python --version
    Command 'python' not found, did you mean:
    command 'python3' from deb python3
    command 'python' from deb python-is-python3

原因:Ubuntu24.02自带python3 解决方法: python3 --version

2. 未安装pip

执行pip指令报错未安装:

bash 复制代码

pip list packages
Command 'pip' not found, but can be installed with:
sudo apt install python3-pip

原因:未安装pip 解决方法:

bash 复制代码

sudo apt install python-pip

3. 部署python项目

在较新的 Ubuntu 版本中，系统 Python 环境被标记为"外部管理环境"，不再支持直接使用pip安装卸载python库，这是为了保护系统完整性。

方法1，使用apt install 安装相应的python库(不推荐)

bash 复制代码

# 检查是否有 FastAPI 的包
apt search fastapi
sudo apt install python3-venv
sudo apt install python3-pip

方法2. 使用虚拟环境安装相应的python库(推荐)

推荐使用方案2.（虚拟环境） ，这是 Python 开发的最佳实践，可以避免包冲突和系统环境污染。

bash 复制代码

# 安装虚拟环境工具
sudo apt install python3.12-venv

# 创建虚拟环境
python3 -m venv myenv

# 激活虚拟环境
source myenv/bin/activate

# 在虚拟环境中安装 FastAPI
pip install fastapi uvicorn

# 使用完成后退出虚拟环境
# deactivate