部署React应用至gh-pages时遇文件名过长及权限问题求助

报错原因 #

• Windows系统下Git默认限制文件名长度，超长文件名的文件无法创建，导致克隆后检出失败
• 修改Git系统级配置时未获取管理员权限，触发权限拒绝提示

解决步骤 #

方法1：以管理员身份开启Git长路径支持 #

1. 右键点击PowerShell/命令提示符，选择「以管理员身份运行」
2. 执行命令开启长路径支持：

   git config --system core.longpaths true
   

3. 回到项目目录，重新执行部署命令：

   npm run deploy
   

方法2：使用全局配置绕过权限限制 #

如果无法获取管理员权限，可修改当前用户的Git全局配置：

git config --global core.longpaths true

执行完成后重新运行部署命令即可。

方法3：缩短超长文件名 #

找到报错中提及的超长文件名文件：src/Media/4VGWsLNGhpXExFXdvAMxJ8Y7WxN-NoHaa0Jf01NNjWEZvR9IbI56c2-VrjIsmgZ0Cugensf-3qJDt3tkSRV-Y2LYGHrcPDJJmLPf9zpqFq94ocq16seQT0queKpLauUjwFKD2e7NZbs2jSDeJz0sx_1wr__psiwBSqkrW9kTiTPoe，将其重命名为更简短的名称，同时更新项目中所有引用该文件的代码，之后再执行部署命令。

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