VS Code运行单个Django文件报错，PyCharm可正常运行求助

1. 确认终端工作目录 #

VS Code终端默认工作目录可能不是项目根目录（含manage.py的目录），导致Django无法识别应用模块：

• 运行文件前，用cd命令切换到项目根目录
• 确保VS Code打开的是整个项目根目录，而非单个文件或子目录

2. 手动配置Django环境变量 #

PyCharm会自动配置Django环境，但VS Code终端需要手动设置：

• 终端执行对应命令：

  # Windows
  set DJANGO_SETTINGS_MODULE=你的项目名.settings
  # macOS/Linux
  export DJANGO_SETTINGS_MODULE=你的项目名.settings
  

• 或在单个文件开头添加初始化代码：

  import os
  import django
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
  django.setup()
  

3. 验证VS Code的Python解释器 #

即使终端激活了虚拟环境，VS Code的解释器可能未匹配：

• 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，选择目标虚拟环境的解释器
• 检查.vscode/settings.json中的python.defaultInterpreterPath是否指向虚拟环境的Python路径

4. 调整模块导入方式 #

相对导入在单个文件运行时可能失效：

• 把相对导入改为绝对导入，比如from .models import XXX改为from 应用名.models import XXX
• 或在终端将项目根目录加入Python路径：

  # Windows
  set PYTHONPATH=.;%PYTHONPATH%
  # macOS/Linux
  export PYTHONPATH=.:$PYTHONPATH
  

5. 重新激活虚拟环境 #

偶尔终端的虚拟环境激活状态会异常：

• 关闭当前终端，重新打开后手动激活：

  # Windows
  虚拟环境目录\Scripts\activate
  # macOS/Linux
  source 虚拟环境目录/bin/activate
  

• 激活后执行which python（macOS/Linux）或where python（Windows），确认路径为虚拟环境内的Python

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