如何在Debian系Linux中配置Python3的sys.path以加载自定义模块

方案一：使用.pth文件配置（官方推荐） #

这是最稳定且无需依赖环境变量的方式：

• 先创建你的自定义模块目录，比如~/my_python_modules，如果是集群环境，建议放在共享存储（如NFS）中，方便多机器同步访问
• 执行python3 -m site --user-site，获取当前用户的Python site-packages路径（类似/home/你的用户名/.local/lib/python3.x/site-packages）
• 在上述路径下新建一个后缀为.pth的文件，比如custom_modules.pth，文件内直接写入自定义模块目录的绝对路径：

  /home/你的用户名/my_python_modules
  

• 保存文件后重启Python进程，执行import sys; print(sys.path)即可看到该目录已被加入搜索路径

方案二：正确配置PYTHONPATH环境变量 #

你之前设置无效大概率是配置方式有误，正确步骤：

• 编辑~/.bashrc文件，添加以下内容：

  export PYTHONPATH="/home/你的用户名/my_python_modules:$PYTHONPATH"
  

• 执行source ~/.bashrc让配置立即生效，或者重新登录终端
• 验证：先执行echo $PYTHONPATH确认路径已添加，再启动Python检查sys.path是否包含目标目录

集群多机器适配技巧 #

针对你8台配置略有差异的Ubuntu机器：

• 优先将自定义模块目录放在共享存储上，所有机器挂载同一路径，避免重复复制模块
• 若使用.pth方案：每台机器执行对应Python版本的python3.x -m site --user-site（x为具体版本号），在输出的路径下创建相同的.pth文件
• 若使用PYTHONPATH方案：确保所有机器的.bashrc配置指向共享存储的统一路径

注意：全程使用用户级配置，不要修改系统级site-packages目录，避免影响其他用户或系统Python环境。

内容的提问来源于stack exchange，提问作者ForDummies