通过编辑器使用Git

通过编辑器使用Git

介绍

什么是 Git？

Git 是一个代码版本管理系统，在软件项目中被广泛使用。它尤其可以让你：

• 拥有代码的历史记录，可以随时回退；
• 在多台设备之间同步，并与团队在同一批文件上协作，同时减少冲突；
• 维护同一份代码的多个版本，以便在不破坏可用版本的情况下开发和实验；
• 轻松地备份项目。

由 Git 管理版本的文件夹称为仓库（英文 _repository_ 或 _repo_）。

什么是代码托管平台？

Git 既是一个可以在本地（在你的电脑上或在 Leek Wars 的编辑器中）使用的软件，也可以与代码托管平台（forge）交互。这是一种托管 Git 仓库的服务器。

Leek Wars 支持多个托管平台，最简单的是从下面这些中选一个：

• GitHub，微软（美国）的专有服务。Leek Wars 的代码也托管在这里。
• GitLab.com，GitLab（美国）的官方实例，GitLab 是一款可自行托管的自由软件。
• Bitbucket，Atlassian（美国）的专有服务。
• Codeberg，Forgejo 的官方实例，Forgejo 是社区维护、可自行托管的自由软件，由一个德国非营利组织托管。

也可以使用其他基于 GitLab、Bitbucket、Forgejo、Gitea 或 Gogs 的托管平台，例如 framagit.org 或 gitea.com。

为已有的 AI 使用 Git

首先，AI 必须位于一个文件夹中，而不是根目录。创建一个文件夹，右键单击该文件夹，选择“初始化 Git 仓库”。这个文件夹将包含所有要纳入 Git 的文件。

文件列表（左侧菜单）顶部会出现一个带有分支图标的 Git 标签页。点进去。

进行提交

（提交，英文 commit）

在 Git 标签页顶部，检查下拉选择器中选中的是你想要的仓库（如果你有多个的话）。

当仓库中的文件被修改时，修改会出现在 Git 标签页中。此时它们还是未暂存的：就像一份草稿，尚未刻进历史记录的石碑。

当你想把修改记录进历史时，点击 ➕ 按钮将它们暂存。在“提交信息”字段中用几个词概括这些修改，然后确认。

注意：为了看清 Git 标签页中的所有按钮，可能需要拖动它的右边缘把它向右拉宽！

历史记录是一个提交列表，每个提交是一组修改，带有日期和信息。这样做的目的是可以查到某项修改是什么时候做的、可以回退，还可以把修改分组以避免代码处于半成品状态……

连接到托管平台

在托管平台上的配置

在一个 Git 托管平台上注册账号，并在那里创建一个空仓库。找到你仓库的地址，它应该类似于 https://exemple.net/mon-pseudo/mon-depot.git。这就是你仓库主页的地址，末尾多了 .git。

接下来需要授权 Leek Wars 访问该仓库。具体步骤取决于托管平台。

• GitHub：最简单的方法是直接从编辑器中安装 Leek Wars 的 GitHub App（见下文）。另一种方法是创建一个令牌：点击你的头像，Settings，Developer Settings（在最底部）。在打开的页面中选择 Personal access tokens，Tokens (classic)。选择一个有效期（例如 90 天），并且只授予参与该仓库所需的权限。
• Forgejo：账号设置，应用，新建访问令牌。授予对 "repository" 的读写权限。

如果你创建了令牌（token），请妥善保存，不要弄丢！

在 Leek Wars 上的配置

在 Git 标签页底部，点击云朵图标按钮“远程设置”。

在这里声明远程仓库（remote）：填写一个名称（例如 origin），粘贴仓库的 URL，然后点击“添加”按钮。这一步是推送任何内容之前必不可少的。

对于身份验证，选择你的托管平台：GitHub、GitLab、Bitbucket 或 Forgejo。

• GitHub：主要途径是“安装 GitHub App”按钮。安装时，选择要授权访问的仓库；回到 Leek Wars 后，你可以直接从这些仓库中选择一个作为远程仓库。另一种方法是把 Personal Access Token 粘贴到“访问令牌”字段中。
• GitLab 和 Bitbucket：把令牌粘贴到“访问令牌”字段中。如果你使用的是自行托管的实例而不是 gitlab.com 或 bitbucket.org，请勾选“自托管实例”并填写托管平台的地址（GitHub 也有这个复选框）。
• Forgejo：这个平台没有“自托管实例”复选框，实例地址字段始终显示（预填为 codeberg.org）。如有需要请填写你的实例地址，并把令牌粘贴到“访问令牌”字段中。

把提交发送到服务器

目前，提交历史只保存在 Leek Wars 中。要把它发送到托管平台，需要用 Git 标签页最底部的 ⬆ 按钮进行推送（push）。

以后每当你想发送新的提交时，都做一次推送。

其他功能

编辑器和 Git 标签页还提供：

• 克隆仓库：菜单“文件”→“克隆 Git 仓库”，填写仓库的 URL 和目标文件夹。
• 拉取（pull）：“拉取（pull）”按钮用于获取远程仓库的提交，可选择 merge 或 rebase 策略（“拉取策略”）。
• 分支：分支选择器可以切换分支、创建分支（“新建分支...”）以及查看远程分支。
• 历史与差异：“历史”按钮列出所有提交，点击某个被修改的文件即可显示它的差异。
• 解决冲突：合并或变基时如果发生冲突，编辑器可以让你解决冲突然后继续。
• 撤销上次提交：被撤销提交的更改会保留在索引中。
• 压缩仓库：减少仓库占用的空间（对配额很有用）。
• 内置 Git 终端：显示编辑器执行过的 Git 命令日志。