通过编辑器使用Git

> 编辑器详解

Git（读作 /ɡɪt/）是一个代码版本管理系统，在软件项目中被广泛使用。它主要可以：

由 Git 进行版本管理的文件夹叫作仓库（英文为 _repository_，简称 _repo_）。

Git 是一个可以在本地使用的软件（在你的电脑上或在 Leek Wars 的编辑器里），但它也可以和代码托管平台交互。代码托管平台就是托管 Git 仓库的服务器。

Leek Wars 支持多个代码托管平台，最简单的做法是从下面几个中选一个：

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

首先，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_），请妥善保管，不要弄丢！

在 Git 选项卡底部，点击云朵按钮“远程设置”。

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

身份验证方面，选择你的代码托管平台：GitHub、GitLab、Bitbucket 或 Forgejo。

GitHub：主要方式是点击“安装 GitHub App”按钮。安装时，选择要授权访问的仓库；回到 Leek Wars 后，你就可以直接从这些仓库中选一个作为 remote。你也可以在“访问令牌”输入框中粘贴一个 Personal Access Token。
GitLab 和 Bitbucket：在“访问令牌”输入框中粘贴令牌。如果你使用的是自托管实例，而不是 gitlab.com 或 bitbucket.org ，请勾选“自托管实例”，并填写代码托管平台的地址（GitHub 也有这个选项）。
Forgejo：这个平台没有“自托管实例”选项，实例地址输入框会一直显示（默认填好了 codeberg.org ）。如有需要，填写你的实例地址，然后在“访问令牌”输入框中粘贴令牌。

目前，提交历史只保存在 Leek Wars 里。要把它发送到代码托管平台，需要点击 Git 选项卡最底部的 ⬆ 按钮进行 推送（push）。

每次想发送新的提交时，都推送一次即可。

编辑器和 Git 选项卡还提供以下功能：