Windows环境下保留__init__.py的Python模块导入冲突问题（Pylint/Django场景）问询

Python运行时加载模块完全依赖*sys.path列表的搜索顺序，不同的启动入口、运行方式会完全改变sys.path*的初始值，这是你遇到两种导入写法表现相反的核心原因：

• 直接运行脚本（如python functions/main.py）的场景：Python会自动把**当前脚本所在的目录（即test/functions/）**追加到sys.path最前端。
  • 这种配置下，from sub_func import add可以直接找到同目录下的sub_func包，运行正常；但from functions.sub_func import add需要搜索到上层的test/目录才能定位到functions包，而test/不在sys.path里，所以会抛出ModuleNotFoundError。
  • 对应Pylint的检测逻辑：Pylint做静态检查时，默认以你在编辑器中打开的项目根目录（本例为test/）作为搜索根目录，它的搜索路径里没有自动加入test/functions/目录，所以识别不到sub_func包，触发import_error告警；但当你写from functions.sub_func import add时，Pylint可以在test/下定位到functions包，告警自然消失——这就是静态检测和运行时路径逻辑不匹配的典型表现。
• Django启动的场景：Django初始化时会自动把**项目根目录（即包含manage.py的test/目录）**追加到sys.path最前端。
  • 这种配置下，from functions.sub_func import add可以从根目录开始定位到完整的包路径，运行正常；但from sub_func import add需要搜索test/functions/目录才能找到sub_func包，而这个目录不在Django配置的搜索路径里，所以会抛出模块未找到错误。

注：你提到的from sub_funct import add属于拼写错误，少写了字母c，这种写法在任何场景下都会触发模块找不到的错误，和路径逻辑无关。

不需要删掉任何__init__.py文件，只需要统一导入逻辑、适配不同运行场景的路径即可，推荐两种方案：

方案1：使用包内相对导入（最符合Python包设计规范） #

在main.py中直接使用相对导入写法：

from .sub_func import add

• 适配性：只要把functions作为完整的包加载（无论是Django从项目根目录导入，还是在项目根目录下用python -m functions.main的方式启动main.py），这种写法都可以正常生效，不需要手动修改*sys.path*。
• Pylint兼容性：只要正确将test/配置为Pylint的项目根目录，Pylint会自动识别带__init__.py的包结构，不会触发导入告警。
• 注意：这种写法不兼容“直接进入functions目录运行python main.py”的启动方式——这种方式本身不符合Python包的设计逻辑，会抛出相对导入缺少父包的错误。

方案2：统一使用全路径绝对导入+动态路径补全 #

如果你想让main.py既可以直接运行，又兼容Django、不触发Pylint告警，可以在导入逻辑前动态将项目根目录加入搜索路径：

import sys
from pathlib import Path

# 定位项目根目录（当前main.py位于test/functions/下，向上两层即为test/根目录）
PROJECT_ROOT = Path(__file__).resolve().parent.parent
# 将根目录加入搜索路径最前端，避免和其他路径冲突
sys.path.insert(0, str(PROJECT_ROOT))

# 之后统一使用从项目根开始的全路径导入，Pylint可以正确识别
from functions.sub_func import add

• 适配性：
  • 直接运行main.py时，脚本会自动把test/目录加入搜索路径，不会再抛出找不到functions包的错误；
  • Django启动时本身就已经把test/目录加入了搜索路径，这里的路径补全不会造成冲突，导入逻辑完全正常；
• Pylint兼容性：全路径导入完全匹配Pylint以项目根为起点的搜索逻辑，不会触发导入告警。

你之前遇到的两种写法分别在不同场景下跑通，本质都是“路径意外匹配”，并不是写法本身通用：

• 用from sub_func import add能在functions目录下直接跑通，只是因为运行时Python把当前目录加入了搜索路径，这种写法把functions目录当成了独立项目，一旦切换启动入口就会失效；
• 用from functions.sub_func import add能在Django下跑通，只是因为Django自动把项目根目录加入了搜索路径，这种写法要求运行时必须能定位到项目根目录，不然就会报错。

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