Django 4.1独立脚本运行报错：找不到sport_api模块

补全Python路径配置 #

如果你的脚本不在项目根目录（即存放manage.py的目录），Python无法识别sport_api模块是正常情况，需要把项目根目录手动添加到Python路径中。在脚本开头加入以下代码：

import sys
import os

# 根据实际目录结构调整路径，若脚本在子目录则多嵌套一层os.path.dirname
project_root = os.path.dirname(os.path.abspath(__file__))
sys.path.append(project_root)

例如脚本放在scripts子目录下，就修改为project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))，确保路径指向manage.py所在的根目录。

核对DJANGO_SETTINGS_MODULE的完整路径 #

不要仅写settings，必须使用项目名+settings的完整模块路径。比如你的项目名为sports_project，settings.py在sports_project目录下，就要这样设置：

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'sports_project.settings')

检查sport_api应用的目录规范 #

• 确保sport_api目录内存在__init__.py文件（空文件即可，没有的话Python不会将其识别为合法模块）
• 确认INSTALLED_APPS里的'sport_api'和目录名称完全一致，大小写也必须匹配（比如目录是Sport_API就会触发报错）

更换脚本运行位置 #

直接到项目根目录（manage.py所在目录）下执行脚本，使用命令：

python 你的脚本路径/script.py

不要在脚本所在的子目录内直接运行，这样Python能自动识别项目根目录下的模块。

确认初始化代码的顺序 #

脚本开头的代码必须遵循以下顺序：

1. 导入sys、os模块
2. 将项目根目录添加到sys.path
3. 设置DJANGO_SETTINGS_MODULE环境变量
4. 导入django并调用django.setup()
5. 最后导入sport_api相关模块

正确示例：

import sys
import os

# 调整路径指向项目根目录
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(project_root)

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'sports_project.settings')

import django
django.setup()

# 此时可正常导入sport_api的模块
from sport_api.models import Match

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