Django如何从项目根目录导入独立自定义包内的函数

方案1：通过settings配置注册包路径（推荐，适配独立第三方包场景） #

你需要的配置注册方式可按如下步骤操作：

• 打开myproject/settings.py，在文件头部确认/添加路径配置，将项目根目录加入Python模块搜索路径，保证全局可识别根目录下的自定义包：

  import sys
  from pathlib import Path
  
  # Django默认自带BASE_DIR定义，指向包含manage.py的项目根目录
  BASE_DIR = Path(__file__).resolve().parent.parent
  # 兜底将根目录加入模块搜索路径，兼容不同部署/启动环境
  if str(BASE_DIR) not in sys.path:
      sys.path.insert(0, str(BASE_DIR))
  

• 确认logic目录下存在空的__init__.py文件，Python会将该目录识别为可导入的正式包，这是独立包的必备结构。
• 配置完成后，即可在app/views.py中直接导入目标函数，不需要写多层相对导入，文件上传场景的调用示例如下：

  # app/views.py
  from django.http import HttpResponse
  # 直接从根目录的logic包导入函数
  from logic.do_stuff import call_me
  
  def file_upload(request):
      if request.method == "POST" and request.FILES.get("upload_file"):
          # 原有文件校验、保存逻辑
          # ......
          # 业务触发点调用目标函数
          call_me()
          return HttpResponse("文件上传成功，业务逻辑已触发")
      # 其余GET/异常场景逻辑
      return HttpResponse("请上传文件")
  

方案2：注册为Django应用（适配logic包含Django特性的场景） #

如果你的独立logic包本身包含Django模型、信号、管理后台配置等Django生态能力，可以直接将其注册到应用列表：

• 打开myproject/settings.py，找到INSTALLED_APPS配置项，在列表中添加'logic'：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      # 新增注册自定义logic包
      'logic',
  ]
  

• 注册后同样支持全局导入包内所有函数、类，同时可正常使用Django的ORM、信号等内置能力。

常见问题说明 #

• 你之前使用的from .logic import do_stuff是相对导入语法，.代表当前views.py所在的app目录，只会查找app目录下的logic.py文件，无法定位到根目录的logic包，这是导入失败的核心原因。
• 配置完成后如果仍报导入错误，重启Django开发服务，清理项目下的__pycache__缓存目录后再重试即可。

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