温馨提示×

Ubuntu如何设置Python路径

小樊
46
2026-07-14 06:42:42
栏目: 编程语言

在 Ubuntu 中设置 Python 路径,常见场景有 设置 Python 可执行文件路径设置 PYTHONPATH(模块搜索路径)设置虚拟环境路径。下面按常见需求详细说明。


一、查看当前 Python 路径

1️⃣ 查看 Python 可执行文件位置

which python3

ls -l $(which python3)

2️⃣ 查看 Python 模块搜索路径

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

二、设置 Python 可执行路径(指定默认 python)

Ubuntu 默认可能只有 python3,没有 python

✅ 推荐方式:使用 update-alternatives

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1

查看是否成功:

python --version

⚠️ 不建议直接删除或覆盖系统 python3,避免破坏系统工具。


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

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

export PYTHONPATH=/your/custom/path:$PYTHONPATH

验证:

echo $PYTHONPATH

2️⃣ 永久设置(用户级)

编辑 ~/.bashrc~/.zshrc

nano ~/.bashrc

添加:

export PYTHONPATH=/your/custom/path:$PYTHONPATH

生效:

source ~/.bashrc

3️⃣ 系统级设置(不推荐)

sudo nano /etc/environment

添加:

PYTHONPATH="/your/custom/path"

四、使用虚拟环境(强烈推荐)

避免污染系统 Python 路径。

1️⃣ 创建虚拟环境

python3 -m venv venv

2️⃣ 激活虚拟环境

source venv/bin/activate

激活后:

  • python 指向虚拟环境
  • sys.path 自动包含 venv 目录

退出:

deactivate

五、pip 安装路径相关

查看 pip 安装路径

python3 -m pip show 包名

指定安装路径

pip install --target=/your/path package_name

六、常见问题

❓ 为什么 Ubuntu 没有 python 命令?

  • Ubuntu 20.04+ 默认只有 python3
  • 系统工具依赖 python3,不建议强行改系统 python

❓ 修改路径后 Python 找不到模块?

  • 检查 sys.path
  • 确认路径是否加入 PYTHONPATH
  • 优先使用虚拟环境

七、总结(推荐做法)

优先使用虚拟环境
不要随意修改系统 Python
PYTHONPATH 仅用于特殊需求


如果你有具体场景(例如:多个 Python 版本、conda、Docker、系统服务、cron 定时任务),可以告诉我,我可以给你更精确的配置方案。

0