Python跨Windows与Linux平台模块导入问题咨询（附示例代码）

先帮你理清楚项目结构，方便定位问题：

你的项目根目录/
├── main.py
└── parser/
    ├── __init__.py
    └── toto.py

再回顾下你给出的代码片段：

• parser/__init__.py：

from .toto import Parser as TotoParser

• parser/toto.py：

class Variable(object):
    def __str__(self):
        return "totoVariable"
class Parser(object):
    @staticmethod
    def parse(data):
        return Variable()

• main.py：

#!/usr/bin/env python3
from parser import TotoParser
def main():
    print(TotoParser.parse(""))
if __name__ == '__main__':
    main()

常见问题及解决办法 #

跨平台导入问题大多和路径识别或者大小写敏感有关，下面逐个拆解：

1. Linux下的大小写敏感坑

Linux文件系统是大小写敏感的，Windows则完全不敏感。如果你在Linux上跑时报ModuleNotFoundError，先自查：

• 目录/文件名的大小写是不是和代码里的导入语句严格匹配？比如你写的是from parser import ...，实际目录是不是叫Parser？toto.py有没有写成Toto.py？
• 别小看这个细节，这是Linux下导入失败最常见的原因，一定要严格对应。

2. 确保项目根目录在Python的搜索路径里

有时候不管Windows还是Linux，Python找不到parser模块，是因为当前工作目录不在项目根目录，或者根目录没被加入sys.path。

你可以在main.py开头加几行代码，强制把项目根目录加入搜索路径：

#!/usr/bin/env python3
import sys
import os
# 获取当前脚本所在的项目根目录
project_root = os.path.dirname(os.path.abspath(__file__))
if project_root not in sys.path:
    sys.path.insert(0, project_root)

from parser import TotoParser
# 后面的代码不变

3. 相对导入的正确打开方式

你的__init__.py里用了from .toto import ...这种相对导入，这是包内导入的正确写法，只要parser被Python识别为合法包（也就是存在__init__.py文件）就没问题。如果遇到ValueError: attempted relative import in non-package，说明Python没把parser当成包，这时候可以试试用模块方式运行脚本：

# 必须在项目根目录下执行
python -m main

而不是直接python main.py，后者在某些环境下会导致包识别异常。

4. 快速验证步骤

不管在Windows还是Linux，先按下面步骤排查：

• 确认parser目录下确实有__init__.py（哪怕是空文件也行，你这里已经有内容了）
• 切换到项目根目录，执行python main.py或者python -m main，看是不是能正常输出totoVariable

如果还是报错，把具体的错误信息贴出来（比如ModuleNotFoundError的完整提示），这样能更精准地定位问题。

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