VS Code中Python子模块导入疑问：sys.path追加路径后为何仍报错？

核心原因 #

Python的模块搜索路径（sys.path）按顺序查找模块，你遇到的问题根源在于相对路径的基准目录和模块查找逻辑：

• from bulk_load.file2 import func123 正常运行的原因
  当你在feeds目录下运行file1.py时，当前工作目录会被自动加入sys.path。bulk_load是feeds目录下的合法Python包（存在__init__.py），Python能通过包层级关系找到目标模块。

• sys.path.append("bulk_load") 后导入失败的原因
  sys.path.append()接收的相对路径是相对于当前工作目录，而非脚本file1.py所在的目录。如果VS Code的运行工作目录不是feeds（比如你打开的是feeds的上级目录作为工作区），那么"bulk_load"这个相对路径指向的目录不存在，导致添加的路径无效，Python找不到file2.py。
  即便当前工作目录是feeds，直接添加"bulk_load"虽然路径有效，但这种导入方式会把file2.py当作顶级模块，若file2.py内部使用相对导入（如from . import xxx），后续还会引发其他错误。

解决方法 #

方法1：使用绝对路径添加（推荐）

通过脚本所在目录的绝对路径拼接bulk_load路径，避免相对路径的不确定性：

import sys
from pathlib import Path

# 获取file1.py所在的目录（即feeds目录）
current_dir = Path(__file__).parent
# 拼接bulk_load的绝对路径并添加到sys.path
sys.path.append(str(current_dir / "bulk_load"))

# 现在可正常导入
from file2 import func123

方法2：坚持标准包导入（更规范）

直接使用你原本的导入方式from bulk_load.file2 import func123，这种方式符合Python模块规范，无需手动修改sys.path，代码可读性和可维护性更强。

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