我的Django项目无法导入django.shortcuts（Pylint import-error）如何解决？
2026-5-9
解决Pylint无法导入'django.shortcuts'的问题
嘿，这个问题我在开发Django项目时碰到好多次了，别慌，咱们一步步排查解决：
1. 确认虚拟环境是否激活且Pylint使用正确环境
这是最常见的原因！很多时候是Pylint没找到你项目安装Django的虚拟环境：
- 先激活你的项目虚拟环境：
- Linux/macOS：
source venv/bin/activate - Windows：
venv\Scripts\activate
- Linux/macOS：
- 然后检查IDE的Python解释器设置：
- VS Code：点击左下角的Python版本号，选择虚拟环境对应的解释器
- PyCharm：通过
File > Settings > Project: [你的项目名] > Python Interpreter，选中虚拟环境里的Python
2. 检查Django是否安装在当前环境
如果虚拟环境里没装Django，Pylint肯定找不到：
- 激活环境后，运行
pip list看看输出里有没有Django - 如果没有，执行
pip install django（或者pip install -r requirements.txt如果你用依赖文件的话）
3. 安装并配置Pylint的Django插件
Pylint默认对Django的支持不够，需要专门的插件来识别Django的导入规则：
- 先安装插件：
pip install pylint-django - 然后配置Pylint启用它：
- VS Code：打开设置（Ctrl+,），搜索
python.linting.pylintArgs，添加"--load-plugins=pylint_django"到参数列表 - 项目根目录创建
.pylintrc文件，添加一行：load-plugins=pylint_django
- VS Code：打开设置（Ctrl+,），搜索
4. 确保项目根目录被识别为Python源根
有时候Pylint找不到项目的路径，导致导入报错：
- 在IDE里把项目根目录标记为Sources Root（PyCharm右键目录选
Mark Directory as > Sources Root；VS Code可以通过设置python.analysis.extraPaths添加项目路径） - 或者手动设置PYTHONPATH环境变量：
- Linux/macOS：
export PYTHONPATH=/path/to/your/project - Windows：
set PYTHONPATH=C:\path\to\your\project
- Linux/macOS：
5. 清除Pylint缓存
偶尔缓存会导致奇怪的错误，试试清除后重新分析：
- 运行命令：
pylint --clear-cache - 然后重启IDE，让Pylint重新扫描项目文件
内容的提问来源于stack exchange，提问作者Darkskynin
相关产品推荐
相关产品推荐
