本地Python包跨目录导入失败求助（无需上传PyPI）

看起来你遇到的是本地包安装后无法跨目录调用的常见问题，结合你的需求（内部使用、不上传PyPI），这里有几个靠谱的解决方案：

方案1：使用开发模式安装（推荐） #

这是最适合本地开发和内部共享的方式，不仅能让你在任意目录import包，还能在修改代码后立即生效，无需重新打包安装。

步骤很简单：

1. 确保你的包结构里有setup.py（外层pkg目录下，和内层pkg文件夹同级），参考写法：

   from setuptools import setup, find_packages
   
   setup(
       name="pkg",
       version="0.0.1",
       packages=find_packages(),
       # 如果有依赖可以加install_requires，比如pandas等
       install_requires=["pandas>=1.0.0"]
   )
   

2. 打开终端，切换到外层pkg目录（就是包含setup.py的那个目录）
3. 运行命令：

   pip install -e .
   

   这里的-e代表editable（可编辑），pip会把你的本地包链接到Python环境的site-packages里，这样不管你在哪个目录执行Python，都能正常import pkg了。

方案2：检查Python环境一致性 #

如果你已经安装了wheel但跨目录找不到，很可能是安装包的pip和运行代码的Python不是同一个环境。比如你在虚拟环境里用pip install，但在系统Python里运行代码，自然找不到包。

验证方法：

• 在安装包的终端里运行：pip --version，记下Python路径
• 在报错的终端里运行：python --version，对比路径是否一致
  如果不一致，切换到正确的环境（比如激活虚拟环境）后再运行代码，或者用对应环境的pip重新安装。

方案3：手动添加路径到PYTHONPATH #

如果不想用开发模式，也可以手动把包所在目录添加到Python的搜索路径中：

1. 找到你的外层pkg目录的绝对路径（比如Windows下C:\projects\pkg，Linux/macOS下/home/you/projects/pkg）
2. 设置环境变量：
   • Windows：右键「此电脑」→ 属性 → 高级系统设置 → 环境变量，在系统变量里添加PYTHONPATH，值为上述路径
   • Linux/macOS：打开~/.bashrc或~/.zshrc，添加一行：

     export PYTHONPATH="/path/to/your/pkg/directory:$PYTHONPATH"
     

     然后运行source ~/.bashrc（或对应配置文件）生效
3. 之后不管在哪个目录，Python都会搜索这个路径下的包，就能正常import pkg了。不过这个方法的缺点是如果包移动位置，需要手动更新环境变量。

额外提示 #

• 确保内层pkg目录下的__init__.py正确导出你需要的类，比如在__init__.py里写：

  from .main import YourAPIClass
  

  这样你可以直接from pkg import YourAPIClass，不用写from pkg.main import ...，更方便调用。

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