Django虚拟项目操作跳转Sublime Text提示ImportError如何解决

Git唤起作为核心编辑器的Sublime时，默认不会加载终端中激活的Python虚拟环境变量，Sublime进程调用的Python解释器为系统全局版本，未安装Django依赖，因此触发导入错误。这类问题一般在配置了Django项目Git钩子、Sublime安装了Git/Django相关自动执行插件时出现。

触发的报错信息：

raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
)

按以下顺序操作即可修复：

• 重设Git核心编辑器配置，让Git调用Sublime时正确等待编辑完成、继承shell环境，终端执行命令：
  git config --global core.editor "subl -n -w"
  Windows系统需将命令里的subl替换为Sublime的完整安装路径，例如"C:\Program Files\Sublime Text\subl.exe"。
• 为Sublime配置项目专属Python解释器，指向Django虚拟环境内的Python可执行文件：
  打开Sublime加载Django项目后，点击菜单栏 项目 > 编辑项目，在弹出的配置JSON中加入对应配置，将路径替换为本地虚拟环境的实际路径：

  {
      "folders": [
          {
              "path": "."
          }
      ],
      "settings": {
          "python_interpreter": "/your/local/path/to/venv/bin/python3"
      }
  }
  

  Windows系统的虚拟环境Python路径格式为C:/your/local/path/to/venv/Scripts/python.exe。
• 检查项目Git钩子配置：打开项目根目录下的.git/hooks文件夹，查看所有自定义钩子脚本，将脚本开头的shebang声明从通用的#!/usr/bin/env python替换为虚拟环境Python的绝对路径，避免钩子执行时调用全局Python。
• 若Sublime中安装了GitGutter、Djaneiro这类会自动执行Git命令或Django指令的插件，打开对应插件的配置页，将插件内的Python路径、虚拟环境路径选项指向当前项目的虚拟环境目录。
• 临时快速验证方案：操作前先在终端激活Django虚拟环境，再通过subl .命令从当前终端唤起Sublime打开项目，此时Sublime进程会继承终端的虚拟环境变量，不会出现依赖找不到的问题。

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