> [!IMPORTANT] > 具体的Git命令教程，还请自行检索网络，比如[简介 - Git教程 - 廖雪峰的官方网站](https://liaoxuefeng.com/books/git/introduction/index.html) > [!NOTE] > 本文正在补全中，部分内容并不完整 ## Github GitHub 则是一个基于 Web 的 Git 代码托管和协作平台，成立于 2008 年。它的本质是一个远程 Git 仓库服务器，但远不止于此：GitHub 为 Git 添加了图形化的网页界面、社交化的协作机制以及丰富的 DevOps 工具链。开发者可以将本地的 Git 仓库推送到 GitHub 上进行备份、公开分享或私有托管。GitHub 首创了 Pull Request 机制，让代码审核、讨论和合并变得直观而规范，极大地促进了开源项目的贡献流程。此外，它还提供了 Issue 跟踪、Projects 看板、Wiki 文档、GitHub Actions 持续集成、Pages 静态网站托管等增值服务。如果你还没有Github账户，可前往 https://github.com/signup 注册 ## Git 如果你还未安装，可以参阅本站的教程[Git的安装 - 江西财经大学网络安全协会Wiki](https://csec.jxufe.edu.cn/wiki/startdash/install/Git的安装) ### 身份标识安装成功后，我们需要设置一下身份标识 ```bash git config --global user.name "Your Name" # 设置你提交代码时显示的名字 git config --global user.email "your_email@example.com" # 设置你提交代码时关联的邮箱地址 ``` 这里建议邮箱与Github保持一致 ### 初始化仓库 ```bash git init ``` 在项目目录下运行 git init，Git 会创建一个隐藏的 .git 文件夹，你的本地仓库就在这里诞生了 ### 克隆仓库 ```bash git clone <仓库地址> ``` 用 `git clone <仓库地址>` 把远程仓库的代码“下载”下来 ### 基础操作 #### 查看状态 ```bash git status ``` 随时看看当前目录下哪些文件被改动了、哪些暂存了、哪些还没被Git盯上～ #### 添加文件 ```bash git add <文件名> # 添加单个文件 git add . # 添加所有修改（新文件+修改） ``` 把你想要保存的改动“暂存”起来。可以理解为：**把要交的作业放到桌面上，准备正式提交**。 #### 提交快照 ```bash git commit -m "写清楚你做了什么改进" ``` 把暂存区的所有改动永久记录到版本历史中。 #### 查看历史 ```bash git log ``` 或者 ```bash git log --oneline --graph # 简洁图形化展示 ``` 翻看整个仓库的提交记录，按下`q`即可退出 ### 远程同步当你已经用 `git clone` 拉下了代码，或者用 `git init` 加 `git remote add` 连接了远程仓库，就可以用下面两个命令同步啦： ```bash git pull origin main # 从远程仓库拉取最新内容并合并 git push origin main # 把你的本地提交推送到远程仓库 ``` 初次推送某个分支时，可以带上 `-u` 参数：`git push -u origin main`，之后就能直接 `git push` 了～ **注意**：push 前记得先 pull，不然可能会遇到小麻烦（冲突什么的，稍微有点麻烦呢）。 ### 分支 ```bash git branch feature-xxx # 创建新分支 git checkout feature-xxx # 切换到新分支（也可以用 `git switch feature-xxx`） git checkout -b feature-xxx # 或者这样，创建并切换 ``` 开发完成后，切回主分支合并： ```bash git checkout main git merge feature-xxx # 把分支的成果合并到主线 git branch -d feature-xxx # 合并后删除分支 ``` > [!NOTE] > 如果合并时发生冲突（conflict），Git 会在冲突文件中用 `<<<<<<<` 和 `>>>>>>>` 标注出不同版本，你需要手动选择保留哪一段，然后 `git add` + `git commit` 就好啦 ### 撤销与修正谁还没有手滑的时候呢 - **撤销工作区的修改**（还没 `add`）：`git checkout -- <文件名>` - **撤销暂存区**（已经 `add` 但没 `commit`）：`git reset HEAD <文件名>` - **撤销最近一次提交**（保留修改）：`git reset --soft HEAD~1` - **彻底删除最后一次提交**：`git reset --hard HEAD~1` > [!WARNING] > `--hard` 有点点危险，用了它之后后续改动就会消失。建议先用 `git branch backup` 做个备份再操作，比较安心～ ## 添加 SSH 公钥到 GitHub 账户在我们进行push等操作至 Github 时，我们需要进行认证。GitHub 于 2021 年 8 月起正式移除了对通过 HTTPS 使用密码进行 Git 操作的支持 ![image.avif](https://csec.jxufe.edu.cn/i/26c3ff8960b64cd306db644304bb88f4fe10ffbc68fe8ede4f92254b10e0f82d) 所以这里我们推荐配置SSH秘钥。 ### 创建秘钥 #### （选择1）使用默认文件名 ```bash sh-keygen -t ed25519 -C "你的邮箱" ``` 系统会问你**Enter passphrase (empty for no passphrase)**，这里读者自行考虑是否要为秘钥设置额外的密码，如果设置了，那么每次使用秘钥都要再输入这个密码，如果不需要则按下`Enter`两次跳过此操作会在你的`~/.ssh/`目录下生成`ed25519`（私钥）和`ed25519.pub`（公钥）两个文件 #### （选择2）使用自定义文件名如果你要管理多个 SSH 密钥可以这样操作，便于区分不同的秘钥用途 ```bash ssh-keygen -t ed25519 -C "你的邮箱" -f ~/.ssh/id_ed25519_github ``` 与上面的操作一致，不过最终生成的文件分别为`id_ed25519_github`（私钥）和`id_ed25519_github` 随后你需要配置SSH Config文件 ```bash nano ~/.ssh/config ``` 填入下面的内容 ``` # GitHub 配置 Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github IdentitiesOnly yes ``` 最后保存退出 > [!NOTE] > 对于Windows用户，在终端中输入`ii ~\.ssh`可以便捷打开ssh目录，然后创建或编辑config文件，没有config文件的话，可以先创建一个txt文件再更名为config ### 登录 GitHub 并添加公钥点击右上角的头像，进入 **Settings**，在左侧边栏中，找到并点击 **SSH and GPG keys**，随后点击 **New SSH key** ![image.avif](https://csec.jxufe.edu.cn/i/32b31ef8f0cfa9552d38729b333761c52e39382ab1cb23518cc30845f3b00d26) ![image.avif](https://csec.jxufe.edu.cn/i/9439f7fe8e14e7335ced66693b775a3f54f420f932de0edce76db03c3b288556) 在**Title**给这个秘钥取个名字，**Key type**选择**Authentication Key** 在Key中填写上面生成的公钥 ```bash cat ~/.ssh/id_ed25519.pub # 或者 cat ~/.ssh/id_ed25519_github.pub ``` 将输出的内容复制到Key中，最后Add SSH key Windows用户随便一个编辑器打开文件复制内容即可后续clone你的仓库时，就可以使用 ```bash git clone git@github.com:<用户名>/<仓库名>.git ``` 或者修改已有仓库的远程链接 ```bash git remote set-url origin git@github.com:<用户名>/<仓库名>.git ```