本地安装的Python包跨项目导入失败求助

核心问题分析 #

目录名里的-确实会间接影响导入——Python模块名不允许使用连字符，所以你不能直接把test-proj2当作包名导入。但真正导致导入失败的核心原因，大概率是项目结构不符合Python包规范，或者打包配置文件未正确关联可导入模块。

分步解决方案 #

1. 修正项目结构 #

你的test-proj2项目必须遵循Python包的标准结构，正确结构示例：

test-proj2/          # 项目根目录（名字带-没问题，仅作为项目文件夹）
  pyproject.toml     # 或 setup.py，打包配置文件
  test_proj2/        # 真正的可导入包（名字用下划线，符合Python模块命名规范）
    __init__.py      # 必须存在，标记该目录为Python包
    proj2_functions.py  # 存放add函数的文件

注意：可导入的包名是test_proj2（下划线），而非外层的test-proj2（连字符）。

2. 修正打包配置文件 #

如果使用pyproject.toml，确保配置关联正确的可导入包：

[project]
name = "test-proj2"  # PyPI允许包名带-，不影响安装
version = "0.1.0"
packages = ["test_proj2"]  # 这里要和可导入的包名（下划线版本）一致

如果使用setup.py，配置如下：

from setuptools import setup, find_packages

setup(
    name="test-proj2",
    version="0.1.0",
    packages=find_packages()  # 自动识别项目中的合法Python包
)

3. 重新安装包 #

先卸载已安装的旧版本，避免配置冲突：

pip uninstall -y test-proj2

然后在test-proj2项目根目录下，重新安装（推荐开发模式，修改代码无需重复安装）：

pip install -e .
# 普通安装可执行：pip install .

4. 验证导入有效性 #

打开Python命令行，依次执行以下命令测试：

import test_proj2
from test_proj2.proj2_functions import add

如果仍报错，执行以下命令检查包的安装路径：

pip show test-proj2

查看输出中的Location字段，确认路径指向虚拟环境的site-packages（普通安装）或你的test-proj2项目根目录（开发模式）。同时可在Python中检查sys.path，确认该路径已被包含：

import sys
print(sys.path)

5. PythonPATH配置补充 #

若手动添加PythonPATH，需将包含test_proj2包的目录（即test-proj2项目根目录）加入，而非test-proj2的子包路径。不过只要打包配置正确，pip安装后会自动处理sys.path，无需手动添加。

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