温馨提示×

怎样在Ubuntu设置Python路径

小樊
33
2026-07-01 00:36:29
栏目: 编程语言

在 Ubuntu 上设置 Python 路径,常见场景有 设置可执行路径(PATH)设置 Python 模块搜索路径(PYTHONPATH) 以及 指定默认 python 版本。下面按常见需求说明。


一、查看当前 Python 路径

which python
which python3

查看 Python 搜索模块的路径:

python3 -c "import sys; print(sys.path)"

二、设置 Python 可执行文件路径(PATH)

1️⃣ 临时设置(仅当前终端有效)

export PATH=/usr/bin/python3:$PATH

或指定某个 Python 版本:

export PATH=/usr/local/bin/python3.10:$PATH

2️⃣ 永久设置(推荐)

对当前用户生效

编辑 ~/.bashrc~/.zshrc

nano ~/.bashrc

添加:

export PATH=/usr/local/bin/python3.10:$PATH

生效:

source ~/.bashrc

三、设置 Python 模块搜索路径(PYTHONPATH)

用于让 Python 找到你自己写的包或模块

1️⃣ 临时设置

export PYTHONPATH=/home/user/myproject:$PYTHONPATH

验证:

python3 -c "import sys; print(sys.path)"

2️⃣ 永久设置

nano ~/.bashrc

添加:

export PYTHONPATH=/home/user/myproject:$PYTHONPATH

然后:

source ~/.bashrc

四、设置 Ubuntu 默认 Python 版本

⚠️ 不推荐直接删除或替换系统 python3

使用 update-alternatives(安全)

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 2

切换版本:

sudo update-alternatives --config python

五、虚拟环境中设置 Python 路径(推荐做法)

创建虚拟环境

python3 -m venv venv
source venv/bin/activate

虚拟环境会自动:

  • 使用独立 Python
  • 忽略系统 PYTHONPATH
  • 避免路径污染

六、常见问题

❓ 为什么 import 找不到模块?

  • PYTHONPATH 没设置
  • 模块不在当前目录
  • 使用了虚拟环境但未激活

❓ pip 安装的包找不到?

确认 pip 和 python 对应:

which python
which pip

建议:

python -m pip install xxx

七、总结

需求 方法
设置 Python 可执行路径 export PATH=...
设置模块搜索路径 export PYTHONPATH=...
切换默认 Python update-alternatives
项目开发 ✅ 使用虚拟环境

如果你能说明 具体场景(如:多版本 Python、conda、Docker、系统服务、PyCharm),我可以给你更精确的配置方案。

0