Linux下从Git本地安装Python包后，无需设置PYTHONPATH解决模块缺失

方法1：直接修改二进制启动脚本的sys.path #

你安装的程序启动脚本在$HOME/.local/bin目录下，直接修改这个脚本就能解决问题：

1. 找到对应程序的启动脚本，比如$HOME/.local/bin/your-program-name
2. 用文本编辑器打开它，比如执行nano $HOME/.local/bin/your-program-name
3. 在脚本开头的Python代码段最上方，添加以下代码（优先推荐第二种，避免硬编码Python版本）：
   • 硬编码指定系统site-packages路径（适合版本固定的情况）：

     import sys
     sys.path.append('/usr/lib/python3.11/site-packages')
     

   • 自动获取系统site-packages路径（适配不同Python版本）：

     import sys
     import site
     # 把系统所有site-packages路径加入搜索列表
     sys.path.extend(site.getsitepackages())
     

4. 保存退出后，直接启动程序即可，无需再设置PYTHONPATH。

方法2：调整脚本的sys.path优先级（如果原有脚本限制了路径） #

有些由setuptools生成的启动脚本，会强制把本地安装的包路径放到sys.path最前面，导致系统包被屏蔽。你可以：

1. 打开启动脚本，找到类似下面的代码段：

   import sys
   sys.path.insert(0, '/home/your-user/.local/lib/python3.11/site-packages')
   

2. 把sys.path.insert(0, ...)改成sys.path.append(...)，让系统site-packages的优先级更高；或者直接把系统路径插入到列表最前面：

   sys.path.insert(0, '/usr/lib/python3.11/site-packages')
   

补充：重新安装时避免问题的小技巧 #

如果之后需要重新安装这个包，也可以在安装时直接指定让程序优先读取系统包：
执行安装命令时加上--install-lib参数，把包安装到系统site-packages目录（需要sudo权限）：

sudo python setup.py install --install-lib=/usr/lib/python3.11/site-packages

或者用pip安装（如果支持的话），加上--user参数也不会干扰系统包，但如果你已经用setup.py安装过，先执行python setup.py install --record files.txt，然后删除列出的文件再重新安装。

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