type
status
date
slug
summary
tags
category
icon
password
fullWidth
fullWidth

如何管理Unity工程

对于庞大的Unity工程,不建议直接关联整个工程到Git仓库,因为Unity会自动生成大量临时文件(如Library/Temp/Build/),这些文件会显著增加仓库体积且无版本控制意义。
必须提交的目录/文件(核心资产和配置):
  • Assets/
    • 脚本(.cs)、Shader(.shader)、文本资源(如 .json.txt)。
    • 注意:美术资源(如.fbx.png)建议用Git LFS或外部存储(如云盘)。
  • ProjectSettings/
    • 包含Unity编辑器设置(InputManager.assetTagManager.asset 等),需文本化。
  • Packages/
    • 仅提交manifest.json(记录包依赖),忽略packages-lock.json和本地缓存。
🐈‍⬛
我习惯命令行和图形界面结合的方式进行GitHub相关操作(初始化仓库、交互式变基、强制推送等操作使用命令行;切换分支、查看文件状态、提交等操作使用图形界面)。最常用到的图形界面应用程序是GitHub Desktop和VS Code中的Git Lens插件;此外,GitKraken也非常好用(要收费,但价格并不贵)。

创建本地工程仓库

  1. 初始化本地仓库
      • 在 Unity 工程根目录右键打开 Git Bash,执行:
  1. 添加Unity专用的.gitignore
      • 从官方Unity .gitignore模板直接下载并保存到工程目录:
      • 确保忽略Library/Temp/Builds/等Unity自动生成的目录;其他需要忽略的目录或文件类型视项目而定
      • 我个人常用的.gitignore配置,语法规则可以详见:

推送至远端仓库

  1. 关联远程仓库(GitHub Desktop)
      • 打开GitHub Desktop → 左上角Current Repository → Add Existing Repository 
      notion image
      • 在弹出的对话框中选择工程目录,点击Add Repository
      notion image
      • 点击Publish Repository
        • 弹出窗口中输入远程仓库名称(建议与工程同名)和工程描述
      notion image

其他常用操作

大文件用Git LFS追踪

对必须纳入版本管理的大文件(如 .fbx.wav),使用 Git LFS 追踪(GitHub免费版LFS 配额仅1GB,超出需自建LFS服务器或改用云存储)。

更改默认分支

  1. 进入仓库页面 → 点击Settings(仓库右上角齿轮图标)。
    1. notion image
  1. Default branch中点击右侧切换按钮,选择其他分支作为默认分支。
    1. notion image

删除分支和修改分支名

删除分支:
  1. 进入仓库 → 点击上方Code → 选择Branches标签页。
    1. notion image
  1. 找到目标分支 → 点击右侧🗑️ Delete
    1. notion image
修改分支名:
  1. 进入仓库 → 点击上方Code → 选择Branches标签页。
    1. notion image
  1. 找到目标分支点击右侧Rename branch
    1. notion image
  1. 输入新名称,点击Rename branch
  1. 修改本地分支的上游远程分支,并清理缓存,Git Bash中命令行执行:
Relate Posts
【独立游戏】Blizzard Syndrome
Lazy loaded image
【独立游戏】MeloGo
Lazy loaded image
【独立游戏】Grey School Plot
Lazy loaded image
【学校项目】智能家居数字人管家
Lazy loaded image
【毕业设计】基于GarmentCode的参数化和组件化服装版片生成
Lazy loaded image
【Built-in渲染】3D卡通角色NPR前向渲染和物理模拟
Lazy loaded image
【教程留档】NotionNext+Vercel搭建自定义域名的博客流程【UnrealCircle摘要】TypeScript、PuerTS、V8优化实践 by 王宏波
Loading...
Latest posts
【虚幻Slate】虚幻编辑器扩展之开发一个AVG游戏剧情编辑器
2025-12-25
【TypeScript】性能记录框架和装饰器
2025-12-12
【Built-in渲染】绘画色彩理论在卡渲后处理中的应用
2025-12-12
【散文随笔】我的高中生活(二)
2025-12-12
【散文随笔】我的高中生活(一)
2025-12-12
【兴趣爱好】音乐创作存档
2025-12-12