使用cookiecutter-django创建Django项目失败报错求助

从你的报错回溯里能看到核心问题：subprocess.CalledProcessError: Command '['git', 'clone', 'https://github.com/pydanny/cookiecutter-django']' returned non-zero exit status 128。这个错误码128是git克隆仓库时的通用错误，通常和网络、权限或者git配置有关，下面给你几个针对性的解决办法：

第一步：先单独测试git克隆，获取具体错误信息 #

cookiecutter的报错没显示git的详细失败原因，先在命令行单独跑克隆命令：

git clone https://github.com/pydanny/cookiecutter-django

运行后会看到更具体的提示，比如是网络超时、权限拒绝还是其他问题，这能帮你更快定位根源。

常见问题的解决办法 #

1. 网络访问问题（最常见） #

如果是国内环境，访问GitHub经常会有网络波动或者访问受限：

• 可以试试用GitHub的国内镜像地址替换原命令：

  cookiecutter https://github.com.cnpmjs.org/pydanny/cookiecutter-django
  

• 或者给git配置代理（比如你有可用的科学上网工具）：

  # HTTP代理示例，替换成你的代理地址和端口
  git config --global http.proxy http://127.0.0.1:1080
  # SOCKS5代理示例
  git config --global http.proxy socks5://127.0.0.1:1080
  

  用完后可以取消代理：

  git config --global --unset http.proxy
  

2. git权限或配置问题 #

• 如果你是第一次用git访问GitHub，先配置好用户名和邮箱：

  git config --global user.name "你的用户名"
  git config --global user.email "你的GitHub绑定邮箱"
  

• 也可以改用SSH方式克隆（需要先在GitHub上配置好SSH密钥）：

  cookiecutter git@github.com:pydanny/cookiecutter-django.git
  

3. 本地git版本过旧 #

老版本的git可能不支持GitHub的最新协议，先检查版本：

git --version

如果版本低于2.0，建议更新到最新稳定版，Windows用户可以去git官网下载安装包，Linux/macOS用包管理器更新即可。

4. cookiecutter缓存残留问题 #

如果之前尝试克隆失败过，cookiecutter可能保存了损坏的缓存文件：

• Windows系统：找到C:\Users\<你的用户名>\.cookiecutters\cookiecutter-django目录，直接删除它
• 然后重新运行cookiecutter命令

备用方案：手动克隆后再初始化 #

如果以上方法都不行，先手动把仓库克隆到本地，再用cookiecutter指向本地目录：

# 手动克隆仓库
git clone https://github.com/pydanny/cookiecutter-django
# 用cookiecutter加载本地模板
cookiecutter ./cookiecutter-django

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