Python跨文件夹导入函数失败：NameError与ImportError排查求助

为优化代码结构，将对话场景代码拆分至scenes文件夹的scene0.py中，定义了playscene0函数；文本处理函数（print_italics、texttype、textscroll）放在scenetext文件夹的textstuff.py中。

• scene0.py通过from scenetext.textstuff import *导入相关函数，VSCode识别正常，但在importtest文件中调用playscene0()时出现NameError: name 'print_italics' is not defined。
• 已排除循环导入，尝试直接在importtest中导入time和textstuff内容仍无效。
• 后续添加from scenetext.textstuff import print_italics后，又出现ImportError: cannot import name 'print_italics' from 'scenetext.textstuff'。

1. 确认包结构合法性 #

让Python将scenes和scenetext识别为可导入的包，需在两个文件夹下都创建空的__init__.py文件。最终目录结构应为：

项目根目录/
├── scenes/
│   ├── __init__.py
│   └── scene0.py
├── scenetext/
│   ├── __init__.py
│   └── textstuff.py
└── importtest.py

2. 检查函数定义有效性 #

打开scenetext/textstuff.py，确保print_italics等函数是全局定义的：

• 没有拼写错误（比如把print_italics写成printitalic）
• 没有被if __name__ == "__main__":这类条件语句包裹（否则函数仅在直接运行textstuff.py时可见）
• 缩进正确，没有语法错误

示例正确的函数定义：

def print_italics(text):
    print(f"\033[3m{text}\033[0m")

def texttype(text):
    # 你的函数实现
    pass

def textscroll(text):
    # 你的函数实现
    pass

3. 修正scene0.py的导入方式 #

放弃from scenetext.textstuff import *的模糊导入，改为显式导入需要的函数，避免命名冲突或导入遗漏：

from scenetext.textstuff import print_italics, texttype, textscroll

def playscene0():
    # 正常使用导入的函数
    print_italics("这是斜体测试文本")
    # 其他场景逻辑代码

4. 规范importtest.py的导入逻辑 #

importtest.py只需导入scene0中的playscene0函数即可，无需单独导入textstuff的内容（除非importtest自身需要调用这些文本处理函数）：

from scenes.scene0 import playscene0

# 调用场景函数
playscene0()

5. 确保运行路径正确 #

如果以上步骤都完成仍报错，检查运行importtest.py时的工作目录是否为项目根目录：

• 命令行运行时，先切换到项目根目录再执行：python importtest.py
• 或在importtest.py开头添加路径适配代码，强制将项目根目录加入Python搜索路径：

import sys
import os
# 将当前文件所在目录（项目根目录）加入sys.path
sys.path.append(os.path.dirname(os.path.abspath(__file__)))

内容的提问来源于stack exchange，提问作者mister-dew