使用 TortoiseGit 在本地创建 Unity 仓库并与远程仓库关联,可以按照以下步骤进行:
1. 安装 TortoiseGit 和 Git
安装 TortoiseGit 时,会要求安装 Git,确保 勾选“Use Git from the command line”。
2. 在本地创建 Git 仓库
2.1 右键 Unity 项目文件夹
在你的 Unity 项目目录(比如 C:\UnityProjects\MyGame
)上 右键,选择: TortoiseGit -> Create repository here...
这会在项目目录中创建一个
.git
文件夹,表示该目录已经被 Git 管理。
3. 添加 .gitignore 文件
3.1 创建 .gitignore
文件
Unity 生成的临时文件不需要提交,因此需要创建 .gitignore
文件:
- 在项目根目录右键 新建文本文件,命名为
.gitignore
(去掉.txt
后缀)。 - 在
.gitignore
文件中添加以下内容:/[Ll]ibrary/ /[Tt]emp/ /[Oo]bj/ /[Bb]uilds/ /[Ll]ogs/ /[Uu]serSettings/
- 右键
.gitignore
文件,选择 TortoiseGit -> Add,然后点击 确定。
4. 提交初始版本
- 在 Unity 项目目录 右键,选择 Git Commit -> "master"
- 在弹出的提交窗口中:
- 勾选
Select/Deselect All
以选中所有文件 - 在 Commit Message 中输入
"Initial commit"
- 点击 Commit
- 勾选
这一步不会推送到远程仓库,只是在本地完成了初次提交。
5. 关联远程仓库
5.1 创建远程仓库
如果你还没有远程仓库,可以在 GitHub/GitLab/Gitee 上新建一个空的仓库。例如:
https://github.com/yourusername/your-unity-repo.git
不要勾选自动生成 README 文件,否则远程仓库有文件时,可能导致推送失败。
5.2 关联远程仓库
- 在 Unity 项目目录 右键,选择 TortoiseGit -> Settings
- 在左侧导航栏选择 Remote
- 点击 Add new remote
- Remote Name:
origin
- URL: 输入你的远程仓库地址,例如:
https://github.com/yourusername/your-unity-repo.git
- 点击 确定
- Remote Name:
6. 推送代码到远程仓库
-
在 Unity 项目目录 右键,选择 TortoiseGit -> Push
-
在弹出窗口:
- Remote 选择
origin
- Push to branch 选择
master
(或main
) - 勾选 Force overwrite existing branch
- 点击 OK
- Remote 选择
-
TortoiseGit 可能会提示输入 GitHub/GitLab 的用户名和密码:
- 如果使用 GitHub,请使用 Personal Access Token (PAT) 作为密码(GitHub 不再支持账号密码认证)。
- 如果使用 SSH 方式,请确保你已添加 SSH Key。
7. 验证远程仓库是否同步
在浏览器中打开你的 GitHub/GitLab 仓库地址,检查代码是否已经成功推送。
8. 拉取和更新远程代码
8.1 从远程拉取代码
如果你在另一台电脑上使用 Git,或者远程有新提交的代码,可以右键项目目录,选择: TortoiseGit -> Pull
- Remote:
origin
- Remote Branch:
main
(或master
)
8.2 从远程克隆仓库
如果你想在新环境下克隆这个 Unity 项目:
- 右键 目标文件夹(比如
C:\UnityProjects
) - 选择 Git Clone...
- 在 URL 里输入远程仓库地址:
https://github.com/yourusername/your-unity-repo.git
- 选择克隆的本地路径,如
C:\UnityProjects\MyGame
- 点击 OK,等待克隆完成。
9. 配置 Unity 以便更好地使用 Git
为了让 Git 更好地管理 Unity 项目:
- 在 Unity 中,打开
Edit > Project Settings > Editor
- 在 Version Control 选项:
- Mode 选择
Visible Meta Files
- Asset Serialization 选择
Force Text
- Mode 选择
这样可以确保 .meta
文件可见,并且 Unity 资源存储为文本格式,使 Git 版本控制更加友好。
总结
步骤 | 操作 |
---|---|
1. 安装 | 安装 Git 和 TortoiseGit |
2. 初始化仓库 | 右键 Unity 项目目录 → TortoiseGit -> Create repository here |
3. 添加 .gitignore | 创建 .gitignore 文件并添加 Unity 忽略规则 |
4. 提交本地代码 | 右键 Unity 目录 → Git Commit -> "master" |
5. 关联远程仓库 | 在 TortoiseGit -> Settings -> Remote 中添加远程仓库 |
6. 推送代码 | 右键 Unity 目录 → TortoiseGit -> Push |
7. 拉取和克隆 | 使用 Pull 更新,或 Git Clone 获取远程仓库 |
8. Unity 配置 | 设置 Visible Meta Files 和 Force Text |
这样,你的 Unity 项目就可以在本地和远程 Git 仓库之间同步了 🎉!
ChatGPT