VS Code调试Django项目manage.py时出现错误求助

我之前也踩过这个坑！从你给出的错误信息来看，问题大概率出在过时的Python扩展、错误的调试配置或者环境路径不匹配上，咱们一步步来搞定：

1. 先把Python扩展更到最新版本 #

你错误里显示的是ms-python.python-2018.3.1——这可是2018年的老版本了！老扩展对新Python/Django版本的兼容性极差，直接拖垮调试流程：

• 打开VS Code的扩展面板（Ctrl+Shift+X），找到「Python」扩展，点击「更新」按钮。
• 更新完成后重启VS Code，这一步很多时候就能解决一半问题。

2. 检查/重建launch.json调试配置 #

VS Code调试Django需要精准的配置，默认生成的模板大概率能解决问题：

• 点击左侧「运行和调试」图标（Ctrl+Shift+D），如果还没有launch.json，就点击「创建launch.json文件」，选择「Django」模板。
• 生成的配置大概长这样，重点核对几个参数：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Django",
              "type": "python",
              "request": "launch",
              "program": "${workspaceFolder}/manage.py",
              "args": [
                  "runserver",
                  "--noreload"
              ],
              "django": true
          }
      ]
  }
  

  • program要确保指向你项目根目录下的manage.py，用${workspaceFolder}变量最稳妥，避免手动输错路径。
  • --noreload必须加上，不然Django的自动重载会打断调试进程。
  • django参数设为true，让VS Code知道这是Django项目调试。

3. 确认Python环境选对了 #

VS Code经常会默认选全局Python，而你的Django可能装在虚拟环境里：

• 点击VS Code左下角显示的Python版本号，弹出的列表里选择你项目对应的虚拟环境（比如./venv/bin/python这类路径）。
• 先在终端手动跑一遍python manage.py runserver，如果手动能正常启动，那说明环境没问题，就是VS Code的调试配置没跟上；如果手动也报错，先把Django装到位：pip install django。

4. 核对路径与权限 #

从错误信息里的路径/home/user/PROJ/py/lib来看，先确认这个目录下真的有manage.py：

• 在终端运行ls /home/user/PROJ/py/lib/manage.py，如果提示文件不存在，那就是你选的工作区路径错了，把VS Code的工作区切换到真正的Django项目根目录。
• 另外确保你对这个目录有读写权限，必要时可以用chmod -R 755 /home/user/PROJ/py/lib调整权限（谨慎使用，仅限自己的项目目录）。

做完这些步骤，重启VS Code再试一次调试，应该就能正常启动Django的调试服务了！

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