macOS Ventura下Git克隆私有仓库遇权限错误求助

问题重现 #

执行git clone https_url_project时出现以下报错：

warning; unable to unlink ‘Users/Jett/Desktop/this_awesome_file/.git/HEAD.lock’
error: unable to write symref for HEAD: Operation not permitted

已尝试更新brew、升级Git、git reset --hard、删除.gitconfig.lock和.gitconfig文件，但问题未解决。

解决方案 #

• 清理残留目录并修复权限
  先删除部分克隆的残缺目录：

  rm -rf /Users/Jett/Desktop/this_awesome_file
  

  确保目标路径（Desktop）有足够读写权限：

  chmod -R 755 /Users/Jett/Desktop
  

  之后重新执行克隆命令。

• 禁用Git文件系统锁定
  macOS的文件系统特性可能导致Git的锁定机制异常，全局配置关闭文件模式检查：

  git config --global core.filemode false
  

  或者克隆时临时指定配置：

  git clone --config core.filemode=false https_url_project
  

• 检查系统完整性保护（SIP）
  执行命令查看SIP状态：

  csrutil status
  

  如果SIP处于开启状态，可临时关闭后重试克隆（操作后务必重新开启SIP）：

  1. 重启Mac，按住Command+R进入恢复模式
  2. 打开终端执行：csrutil disable
  3. 重启系统后尝试克隆
  4. 克隆完成后再次进入恢复模式，执行csrutil enable开启SIP

• 切换到SSH克隆方式
  配置GitHub SSH密钥后，使用SSH地址克隆避免HTTPS的权限问题：

  git clone git@github.com:你的用户名/仓库名.git
  

• 排查第三方安全软件
  暂时关闭杀毒软件、防火墙等工具，排除它们拦截Git文件操作的可能。

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