Python修复ModuleNotFoundError: No module named 'rest_framework'报错

问题定位与解决目标

该报错表明当前 Python 运行环境中未找到 Django REST Framework（简称 DRF）。DRF 是构建 Web API 的独立工具包，并未内置于 Django 核心依赖中。解决目标是确保目标环境中安装包可用，并在项目配置中正确注册，从而消除导入阻断。

配置前准备条件

确认已安装 Django 框架，并明确正在使用的 Python 虚拟环境路径。建议在执行任何安装操作前，备份现有的 requirements.txt 或锁定文件，以便在依赖冲突时快速回退。

执行安装与配置操作

第1步：在目标环境中安装核心包

打开终端并激活对应虚拟环境，执行以下命令下载最新稳定版：

pip install djangorestframework

目的为补充缺失的运行库。完成后可观察终端输出 Successfully installed 提示。

第2步：将应用加入Django配置清单

进入项目目录，打开 settings.py 文件，在 INSTALLED_APPS 列表中添加 'rest_framework'：

INSTALLED_APPS = [
    # ...
    'rest_framework',
    # ... 其他应用
]

目的是让 Django 初始化加载器能够扫描该模块。保存后重启服务即可生效。

第3步：按需扩展功能组件

若项目需要特定辅助功能，可同步安装配套包：

# 启用接口文档支持
pip install coreapi pyyaml

# 启用 JWT 认证模式
pip install djangorestframework-simplejwt

根据实际业务需求选择性执行，非强制项。

验证安装结果与完成判断

在终端直接运行以下内联脚本检验版本是否成功读取：

python -c "import rest_framework; print(rest_framework.__version__)"

若终端打印出版本号（如 3.15.0）且无报错信息，即表示安装与路径识别均已完成。

异常排查与环境核对

虚拟环境隔离检查

多环境切换常导致包安装错位。请按系统路径激活环境后重新安装：

# Linux / macOS 激活命令
source venv/bin/activate
venv\Scripts\activate    # Windows 激活命令

依赖与路径核对

使用以下命令查看当前环境的已装包与搜索路径：

pip list
python -c "import sys; print('\n'.join(sys.path))"

若发现版本冲突，尝试升级基座框架：pip install --upgrade django djangorestframework。

强制重装与结构校验

缓存损坏可能导致引用失败。执行清理后跳过缓存安装：

pip uninstall -y djangorestframework
pip cache purge
pip install --no-cache-dir djangorestframework

同时核对项目层级，确保 settings.py 与 manage.py 位于合理的父级目录下：

myproject/
├── myproject/
│   ├── __init__.py
│   ├── settings.py
│   └── urls.py
└── manage.py

若手动运行脚本而非通过 manage.py，需声明设置模块环境变量：

# Linux / macOS
export DJANGO_SETTINGS_MODULE=myproject.settings
# Windows
set DJANGO_SETTINGS_MODULE=myproject.settings

完整配置参考

以下为包含基础权限控制的完整 settings.py 配置节段：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
]

REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.AllowAny',
    ]
}

应用上述配置并重启服务后，Django Admin 界面应正常显示相关模块入口，原导入错误彻底消失。

总结

以上就是Python修复ModuleNotFoundError报错的详细内容，更多关于Django REST Framework搭建Web API的资料请关注本站其它相关文章！