EduSKILL.run

Git 新手指南

不会命令行？完全没问题 —— 本站所有 Skill 都可以用网页编辑器完成创建、修改和版本管理。这里只为你介绍最基础的 Git 用法，作为可选进阶。

双通道说明：网页编辑器与 Git 命令行操作的是同一个仓库、同一条提交历史。 你可以全程只用网页，也可以随时切换到命令行，二者无缝互通。

1. Git 是什么？

Git 是一个「版本记录工具」。你可以把它想象成一个无限次的存档系统： 每次修改后存一次档（提交 / commit），任何时候都可以查看历史、对比差异、找回旧版本。 GitHub 式的协作平台（包括本站）都是建立在 Git 之上的。

2. 安装与首次配置

  • Windows：从 git-scm.com 下载安装包
  • macOS：终端执行 xcode-select --install
  • Linux：sudo apt install git

安装后告诉 Git 你是谁（提交记录会显示这个名字）：

git config --global user.name "你的名字"
git config --global user.email "you@example.com"

3. 最小工作流：clone → 修改 → 提交 → 推送

# 1. 把 Skill 仓库克隆到本地（地址在各 Skill 的「本地开发」页可复制）
git clone https://eduskill.idstudio.cc/api/git/owner/skill.git
cd skill

# 2. 随便编辑文件（用任何编辑器）

# 3. 告诉 Git 你改了哪些文件（. 表示全部）
git add .

# 4. 存档（提交），引号里写这次改动的说明
git commit -m "完善触发条件描述"

# 5. 推送到远端（需要访问令牌认证，见下文）
git push origin main

以后每次想同步别人的最新修改，执行 git pull origin main 即可。

4. 推送时的认证：访问令牌（PAT）

为了安全，本站不接受账号密码做 Git 推送认证。你需要生成一个「访问令牌」： 登录后进入 账号设置 → 访问令牌， 点击生成并立即复制（只显示一次）。

首次推送时，Git 会询问：

Username for 'https://eduskill.idstudio.cc': 你的用户名
Password for 'https://eduskill.idstudio.cc': 粘贴刚才的访问令牌（输入时不显示，正常）

5. 常见问题速查

推送被拒绝（rejected / non-fast-forward）

远端有你没有的新提交。先拉取合并：git pull origin main， 解决冲突后再推送。

提示存在冲突（conflict）

用编辑器打开带 <<<<<<< 标记的文件， 手动保留需要的内容并删除标记，然后 git add . && git commit。

不想暴露真实邮箱？

提交作者邮箱只是记录用途，可使用任意邮箱：git config --global user.email "me@example.com"

改错了想回退？

最简单的方式：直接在网页「历史」页里「恢复此版本」，会生成一条撤销提交，不需要任何命令。

记住三条就够用了：clone 拿下来 → commit 存档 → push 推上去。其余的，网页编辑器都能帮你完成。