PYTHONPATH已配置但无法导入自定义Python模块问题求助

核心问题：PYTHONPATH配置路径错误 #

你把PYTHONPATH指向了TestLibrary文件夹本身，但Python需要的是包含TestLibrary的父目录。因为当你执行import TestLibrary时，Python会遍历sys.path里的每个目录，寻找名为TestLibrary的子文件夹（且包含__init__.py）。你现在的配置相当于让Python在TestLibrary文件夹内部找TestLibrary，肯定找不到。

修正步骤 #

1. 修改.zshrc中的PYTHONPATH
   把原来的配置：

   export PYTHONPATH="/Users/my_user/path_to_folder/TestLibrary"
   

   改成父目录路径：

   export PYTHONPATH="/Users/my_user/path_to_folder"
   

2. 刷新环境变量
   在终端执行：

   source ~/.zshrc
   

3. 验证导入
   打开Python交互环境，执行：

   import TestLibrary
   # 或者导入具体模块
   from TestLibrary import test_library_1
   

   注意：你之前写的from TestLibrary import test_library是错的，你的模块文件名叫test_library_1.py，要对应文件名。

额外排查点 #

• 确认__init__.py文件名拼写正确（两个下划线开头结尾，别少打），空文件也没问题，只要存在就能识别为Python包。
• 检查Python版本：Mac可能同时存在多个Python版本，确保你运行的是3.9.13。终端执行python3 --version确认，若版本不对，可能需要用python3.9来启动对应版本的解释器。
• 用Python代码验证路径：

  import sys, os
  print([p for p in sys.path if "path_to_folder" in p]) # 确认父目录在sys.path里
  print(os.listdir("/Users/my_user/path_to_folder")) # 确认TestLibrary文件夹存在
  

替代方案：用site-packages的.pth文件 #

如果不想依赖PYTHONPATH，可以用更稳定的方法：

1. 新建一个文本文件，命名为TestLibrary.pth（后缀必须是.pth），里面写入父目录路径：

   /Users/my_user/path_to_folder
   

2. 将这个文件放到Python 3.9的site-packages目录下，路径一般是：

   /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/
   

3. 重启Python，直接导入即可生效。

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