Unity项目上传至Git遇到多类问题，求有效解决方案
2026-10-8
Unity项目Git接入可行解决方案
前置清理操作
- 打开你的Unity项目根目录，删除所有已存在的
.git文件夹（如果Assets目录下有之前误初始化生成的.git文件夹也要一并删除），Windows系统可执行命令：Remove-Item -Recurse -Force .git，Mac/Linux系统执行命令：rm -rf .git - 删除项目根目录下可能存在的错误配置的
.gitignore文件
配置正确的Unity专属忽略规则
在项目根目录新建名为.gitignore的文件，写入以下标准规则，确保只同步必要文件、过滤本地生成的大体积冗余文件：
# Unity generated folders /[Ll]ibrary/ /[Tt]emp/ /[Oo]bj/ /[Bb]uild/ /[Bb]uilds/ /[Ll]ogs/ /[Uu]ser[Ss]ettings/ # VS/Rider generated files *.csproj *.unityproj *.sln *.suo *.user *.userprefs *.pidb *.booproj *.svd *.pdb *.mdb *.opendb *.vsconfig .idea/ .vscode/ # OS generated files .DS_Store .DS_Store? ._* .Spotlight-V100 .Trashes ehthumbs.db Thumbs.db
注：上述规则会自动过滤掉不需要同步的Library等超大文件夹，从根源解决上传过慢的问题，且不会屏蔽需要同步的Assets、ProjectSettings等核心目录
正式提交上传操作
所有操作均在项目根目录执行，确保Github for Unity插件和Rider能正常识别Git仓库：
- 初始化Git仓库：
git init - 添加所有需要同步的文件：
git add . - 执行本地提交：
git commit -m "首次提交项目初始化" - 绑定远程仓库地址（替换为你自己的仓库地址）：
git remote add origin 你的远程仓库地址 - 推送到远程仓库：
git push -u origin main
特殊情况处理
如果你的Assets目录下存在单个大小超过100MB的资源文件，GitHub会禁止普通提交，此时需要启用Git LFS管理大资源：
- 安装Git LFS后执行
git lfs install开启功能 - 按需添加大资源后缀追踪规则，例如：
git lfs track "*.png" "*.fbx" "*.tile" - 后续提交推送流程和普通操作一致
内容的提问来源于stack exchange，提问作者Fender Selim
相关产品推荐
相关产品推荐
