如何在GitHub Desktop中配置虚拟环境？解决pre-commit提交失败问题

• 打开GitHub Desktop，进入目标项目仓库。
• 点击顶部菜单栏的「Repository」→「Repository Settings」（Windows系统为「文件」→「仓库设置」）。
• 在设置窗口切换到「Git」选项卡，找到「Shell」设置区域。
• 在「Shell path」里指定虚拟环境的激活方式：
  • Windows：填写cmd.exe /k C:\你的虚拟环境路径\Scripts\activate，例如cmd.exe /k D:\my-django-project\venv\Scripts\activate
  • macOS/Linux：填写bash -c "source /你的虚拟环境路径/bin/activate && $SHELL"，例如bash -c "source ~/my-django-project/venv/bin/activate && $SHELL"
• 保存设置后，GitHub Desktop执行Git命令时会自动使用该虚拟环境。

GitHub Desktop默认不会激活虚拟环境，导致pre-commit钩子找不到依赖才提交失败，试试下面几种方法：

方法一：修改pre-commit钩子的Python路径 #

• 找到项目里的.git/hooks/pre-commit文件（该文件由pre-commit自动生成）。
• 把文件开头的Python路径替换为虚拟环境中的Python路径：
  • Windows：将第一行改为#!/C:/你的虚拟环境路径/Scripts/python.exe
  • macOS/Linux：将第一行改为#!/你的虚拟环境路径/bin/python
• 保存后，GitHub Desktop执行钩子时会直接调用虚拟环境的Python，无需手动激活。

方法二：给GitHub Desktop配置环境变量 #

• 进入GitHub Desktop的仓库设置（步骤同第一个问题）。
• 找到「Environment Variables」区域，添加PATH变量：
  • Windows：值填C:\你的虚拟环境路径\Scripts;%PATH%
  • macOS/Linux：值填/你的虚拟环境路径/bin:$PATH
• 保存设置，GitHub Desktop运行钩子时会优先使用虚拟环境内的工具。

方法三：重新绑定pre-commit与虚拟环境 #

• 激活虚拟环境后，在终端执行pre-commit install重新安装钩子，确保钩子绑定虚拟环境的依赖。
• 也可以在项目的.pre-commit-config.yaml中添加配置指定Python版本：

  default_language_version:
    python: /你的虚拟环境路径/bin/python  # Windows系统替换为Scripts/python.exe的路径
  

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