运行Python文件时出现ModuleNotFoundError：找不到walking_panda模块的问题咨询

项目结构 #

walking_panda
└──__init__.py
└── cli.py
└── panda.py
walking_panda.py

执行代码（walking_panda.py） #

#!/usr/bin/env python

from walking_panda.cli import cli

if __name__ == '__main__':
    cli()

报错信息 #

ModuleNotFoundError: No module named 'walking_panda'

问题分析 #

• from语句语法和包引用逻辑没有问题。
• 排除远程仓库未同步本地的可能——你能在VS Code中打开并执行walking_panda.py，说明相关文件已经拉取到本地。
• 核心原因是Python解释器的**模块搜索路径（sys.path）**未包含walking_panda包所在的目录，导致无法识别该包。使用Jupyter Interactive扩展运行时，容易出现工作目录未指向项目根目录的情况，进而引发这个问题。

解决方法 #

方法1：手动在脚本中添加路径 #

在walking_panda.py开头加入以下代码，将项目根目录（walking_panda包所在目录）加入Python模块搜索路径：

import sys
from pathlib import Path

# 将当前脚本所在的项目根目录添加到搜索路径
sys.path.append(str(Path(__file__).parent))

from walking_panda.cli import cli

if __name__ == '__main__':
    cli()

方法2：设置VS Code工作目录 #

1. 在VS Code中直接打开项目根目录（包含walking_panda文件夹和walking_panda.py的文件夹）。
2. 确认Jupyter Interactive扩展的运行工作目录为项目根目录，这样Python解释器会自动将根目录纳入搜索路径，就能识别walking_panda包。

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