Python项目打包入门：跨模块导入失败的解决方法咨询

你遇到的问题核心是：直接运行src/main.py时，Python的模块搜索路径（sys.path）里没有包含my_project的父目录（~/python_ws），导致无法识别my_project作为顶级包；同时VSCode的Python解析器也没定位到正确的项目根目录，所以出现导入提示错误。下面是几种实用的解决方法：

方案一：临时配置PYTHONPATH（快速测试用） #

在终端运行脚本前，先把my_project的父目录添加到PYTHONPATH环境变量，让Python能找到my_project包：

# Linux/macOS 终端
export PYTHONPATH=~/python_ws:$PYTHONPATH
python3 src/main.py

Windows系统用如下命令：

set PYTHONPATH=C:\path\to\python_ws;%PYTHONPATH%
python src/main.py

针对VSCode的语法提示问题，可以在项目的.vscode/settings.json里添加额外搜索路径：

{
    "python.analysis.extraPaths": ["~/python_ws"]
}

方案二：用相对导入+模块方式运行 #

修改main.py里的导入语句为相对导入：

# my_project/src/main.py
from ..classes.my_class import My_class

instance_of_My_class = My_class("My attribute")
instance_of_My_class.print_my_attribute()

然后回到~/python_ws目录，以模块形式运行脚本：

python3 -m my_project.src.main

这种方式不需要修改环境变量，Python会自动把当前目录（~/python_ws）加入模块搜索路径，识别my_project为顶级包。

方案三：将项目安装为可编辑模式（推荐长期开发） #

在my_project目录下创建pyproject.toml配置文件，内容如下：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "my_project"
version = "0.1.0"

回到~/python_ws目录，运行安装命令：

pip install -e .

安装完成后，你的Python环境会永久识别my_project包，不管在哪运行都能正常导入，VSCode的语法提示也会自动恢复正常。

内容的提问来源于stack exchange，提问作者Marc Chambré