Windows本地Git Bash部署Frappe HRMS时环境初始化错误求助

错误核心原因 #

Git Bash环境无法识别Python可执行文件，导致无法创建虚拟环境（venv），最终触发FileNotFoundError。

具体解决步骤 #

• 确保Python加入系统PATH并在Git Bash中可访问

  1. 打开Windows设置 → 系统 → 关于 → 高级系统设置 → 环境变量
  2. 在系统变量的PATH中添加Python安装路径（例：C:\Users\ROHAN\AppData\Local\Programs\Python\Python312）和Scripts路径（例：C:\Users\ROHAN\AppData\Local\Programs\Python\Python312\Scripts）
  3. 关闭所有Git Bash窗口后重新打开，执行python --version和pip --version验证是否能正常输出版本
  4. 若仍提示Python未找到，进入设置 → 应用 → 应用执行别名，禁用Python.exe和Python3.exe的别名（避免系统跳转到微软商店）

• 手动指定Python路径执行初始化
  如果Git Bash无法识别全局Python，直接用绝对路径指定：

  bench init frappe-bench --python "C:/Users/ROHAN/AppData/Local/Programs/Python/Python312/python.exe"
  

• 检查venv模块是否安装
  执行命令验证venv可用性：

  python -m venv --help
  

  若提示模块不存在，重新运行Python安装程序，选择「Modify」，确保「Python Virtual Environment」组件已勾选并完成安装。

• 清理残留文件后重试
  删除之前初始化失败留下的残留文件：

  rm -rf frappe-bench
  

  再重新执行bench init命令（可搭配--python参数指定路径）

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