无法导入site-packages目录下自定义包内的模块该如何解决？

1. 确认目标路径是否在Python的搜索路径中 #

Python仅从sys.path列表内的路径查找包，先检查你的路径是否在其中：

• 执行以下代码查看当前sys.path：

import sys
print(sys.path)

如果/home/saunderstock1/.local/lib/python3.9/site-packages不在输出结果里，就需要手动添加该路径。

2. 临时添加路径（单次会话生效） #

如果只是临时测试，在导入目标包前添加路径：

import sys
sys.path.append("/home/saunderstock1/.local/lib/python3.9/site-packages")
# 之后正常导入你的包
import your_package_name

3. 永久添加路径（长期生效） #

方法1：配置PYTHONPATH环境变量 #

• 若使用bash/zsh终端，编辑~/.bashrc或~/.zshrc文件，加入：

export PYTHONPATH="$PYTHONPATH:/home/saunderstock1/.local/lib/python3.9/site-packages"

保存后执行source ~/.bashrc或source ~/.zshrc使配置生效，后续新开终端会自动加载该路径。

方法2：创建.pth文件 #

在Python的site-packages目录下新建一个.pth文件（例如custom_paths.pth），文件内容直接写入目标路径：

/home/saunderstock1/.local/lib/python3.9/site-packages

Python启动时会自动读取该文件并将路径加入sys.path。

4. 检查包结构是否符合规范 #

有时导入错误并非路径问题，而是包结构不符合Python要求：

• 包目录下必须存在__init__.py文件（Python 3.3+可以是空文件，用于标识这是一个Python包）
• 正确的包结构示例：

your_package/
    __init__.py
    module_a.py
    module_b.py

缺少__init__.py会直接导致导入失败。

5. 验证Python版本匹配性 #

确保你运行代码的Python版本是3.9，因为包存放在python3.9的site-packages目录下：

• 执行python --version或python3 --version查看版本，若当前使用的是其他版本（如3.10），自然无法找到3.9目录下的包，此时需要切换到Python 3.9运行代码。

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