代码提交相关

好的，在 Mac 上配置 Git 非常简单，只需几个步骤即可完成。这里为您提供一份从安装到基础配置的完整指南。

安装 Git

macOS 通常预装了 Git，但版本可能较旧。首先检查是否已安装以及版本号：

打开终端（Terminal）应用程序（你可以在“应用程序” -> “实用工具”中找到它）。
输入以下命令并按回车：
```
git --version
```
- 如果显示了版本号（如 git version 2.39.2 (Apple Git-143)），说明已安装，你可以直接跳到 配置 Git 部分。
- 如果提示 command not found，说明你需要安装 Git。

推荐安装方法：使用 Homebrew

Homebrew 是 macOS 上最流行的包管理器，可以非常方便地安装和管理软件。

安装 Homebrew（如果你还没有安装）：在终端中粘贴并运行以下命令：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
按照屏幕上的提示完成安装。
使用 Homebrew 安装 Git：安装好 Homebrew 后，在终端运行：
```
brew install git
```

其他安装方法

官方安装程序：从 Git 官网下载 macOS 安装程序并直接安装。
- 访问：https://git-scm.com/download/mac
Xcode Command Line Tools：安装 Xcode 或单独安装其命令行工具也会包含 Git。
- 在终端中运行 xcode-select --install，然后点击“安装”即可。

安装完成后，再次运行 git --version 确认安装成功且版本较新。

配置 Git

安装好 Git 后，最重要的一步是配置你的用户信息，这样你每次提交代码时，Git 才知道是谁提交的。

在终端中，设置你的用户名（通常使用你的英文名或 GitHub 用户名）：
```
git config --global user.name "Your Name"
```
（将 "Your Name" 替换为你的名字，例如 "Zhang San"）
设置你的邮箱地址（必须使用你在 GitHub/GitLab 等代码托管平台上注册的邮箱）：
```
git config --global user.email "your.email@example.com"
```
（将 "your.email@example.com" 替换为你的邮箱）
（可选，但推荐）设置默认的文本编辑器。
- 如果你喜欢用 VS Code：
```
git config --global core.editor "code --wait"
```
- 如果你喜欢用 macOS 自带的 Nano：
```
git config --global core.editor "nano"
```
（可选，但推荐）让 Git 输出带颜色，方便阅读：
```
git config --global color.ui auto
```

检查你的配置

要查看你所有的 Git 配置项，可以使用命令：

git config --list

你应该能看到刚才设置的 user.name 和 user.email。

生成 SSH 密钥

为了安全地与远程仓库（如 GitHub）通信，你需要配置 SSH 密钥，避免每次推送代码都输入密码。

生成新的 SSH 密钥：在终端中运行以下命令（替换为你的邮箱）：
```
ssh-keygen -t ed25519 -C "your.email@example.com"
```
- 提示你“Enter file in which to save the key”时，直接按回车使用默认路径（~/.ssh/id_ed25519）。
- 提示你“Enter passphrase”时，可以设置一个密码来增加安全性，也可以直接按回车留空。

将 SSH 密钥添加到 ssh-agent：

# 启动 ssh-agent
eval "$(ssh-agent -s)"
# 将你的 SSH 私钥添加到 ssh-agent
ssh-add ~/.ssh/id_ed25519

将公钥添加到你的 GitHub/GitLab 账户：
- 复制公钥内容：
```
cat ~/.ssh/id_ed25519.pub
```
  终端会显示一长串以 ssh-ed25519 开头、你的邮箱结尾的内容，全部选中并复制。
- 添加到 GitHub：
  1. 登录 GitHub，点击右上角头像 -> Settings。
  2. 在左侧边栏中点击 SSH and GPG keys。
  3. 点击 New SSH key。
  4. 在 "Title" 中起个名字（如 My MacBook Air），然后将刚才复制的内容粘贴到 "Key" 框中。
  5. 点击 Add SSH key。
测试连接：在终端运行：
```
ssh -T git@github.com
```
如果看到类似 Hi username! You've successfully authenticated... 的欢迎信息，说明配置成功！

代码提交规范

feat: 新功能
fix: 修复问题
docs: 文档更新
style: 代码格式（不影响代码运行的变动）
refactor: 代码重构（既不是修复bug也不是添加新功能的代码更改）
perf: 性能优化
test: 添加测试或更新测试
build: 构建系统或外部依赖项的更改（如webpack，npm）
ci: 持续集成相关的变动
chore: 其他不修改 src 或测试文件的更改
revert: 回滚某次提交

Git 命令

基础命令

git add . // 将文件添加到缓存区
git status  // 查看状态
git commit -m "注释内容"  //  将暂存区文件提交至版本库
git log // 查看近期提交状态
git branch // 查看分支
git branch dev // 新建 dev 分支
git checkout dev // 切换到 dev 分支
git push -u origin 分支名称 // 第一次提交分支（推送到云端origin仓库中） 注意：必须切换到此子分支下才能提交！！！-u就表示第一次， 
git merge 分支名称 // 必须先切换到主分支，然后在合并分支

# 如果不下心在master分支上写了代码
# 直接git checkout -b test 就能将修改的文件分配到 test 分支上，然后在 git add 等操作

Git 日志

git log // 查看历史记录
git log -p // 查看详细历史
git log --stat // 查看简要统计

git show // 查看当前的 commit 的改动内容
git show comiitID // 查看某个具体的 commit 的改动内容
git show comiitID a\b.txt // 看指定 commit 中的指定文件

git diff // 比对工作目录和暂存区
git diff --staged // 比对暂存区和上一条提交
git diff HEAD // 比对工作目录和上一条提交
git reflog // 查看记录的每一条指令

Git 克隆分支

# 切换到 dev 分支
git checkout dev

# 创建并立即切换到dev子分支
git checkout -b dev

# 查看所有本地仓库分支和远程分支
git branch -al 

# 检出远程的demo分支到本地
git checkout -b 本地demo分支 origin/远端demo分支

# clone 远端某分支
git clone -b yourBranch https:.../branch

Git 推送分支

# 提交本地分支到远程分支
git push origin 本地分支:远程分支 

# 推送本地的空分支(冒号前面的分支)到远程origin的demo(冒号后面的分支)(没有会自动创建)
git push origin demo:demo

Git 删除分支

# 删除本地的bug分支
git branch -d bug

# 删除远程分支demo
git push origin --delete demo

同步本地和远端的分支

# 查看本地分支和追踪情况
git remote show origin

# 同步删除分支
git remote prune origin

Git 强制覆盖

git fetch --all
git reset --hard origin/master
git pull

变基

rebase——把你指定的 commit 以及它所在的 commit 串，以指定的目标 commit 为基础，依次重新提交一次。

git checkout branch1
git rebase master

另外，在 rebase 之后，记得切回 master 再 merge 一下，把 master 移到最新的 commit :

git checkout master
git merge branch1
git rebase --help // 查看帮助

多次 commit 未 push

git add a.txt // 更新一个文件内容
git commit // commit 到暂存区，没有push
// 重新编辑 a.txt
git add a.txt // 更新一个文件内容
git commit --amend // 该命令并不会再生成一个commit，而是在之前的commit修改

amend 就是重新修改 commit

删除提交错误的push

错误提交到了版本库，此时无论工作区、暂存区，还是版本库，这三者的内容都是一样的，这个时候，我们必须撤销版本库的修改才能解决问题！

git reset有三个选项: --hard、--mixed、--soft

// 仅仅只是撤销已提交的版本库，不会修改暂存区和工作区
git reset --soft 版本库ID
//仅仅只是撤销已提交的版本库和暂存区，不会修改工作区
git reset --mixed 版本库ID
//彻底将工作区、暂存区和版本库记录恢复到指定的版本库
git reset --hard 版本库ID

// 具体步骤
git log // 查看log日志，复制撤销的commitID
git reset --hard commitID // 强制撤销， soft hard mixed 视情况而定
git push origin HEAD --force // 推送到远端

撤销错误添加到暂存区里的文件

# 撤销错误添加到暂存区里的文件 命令行 : 
git rm --cache 文件名

# 上面代码仅仅删除暂存区的文件而已，不会影响工作区的文件 

# 删除暂存区和工作区的文件 命令行：
git rm -f 文件名

出错的内容在你自己的 branch，修改已经push了的commit信息注释

step1：使用【git commit --amend】命令，会进入到vim编辑器。
step2：输入【i】，即进入编辑模式，此时编辑提交信息。
step3：编辑好之后，按键【Esc】，输入【:wq】，即保存和退出。
step4：输入【git push -f】强制提交。
操作完之后，再看提交记录，即可看到修改的注释信息。

出错的内容已经合并到 master，恢复一个版本 git revert HEAD^

上面这行代码就会增加一条新的 commit ，它的内容和倒数第二个 commit 是相反的，从而和倒数第二个 commit 相互抵消，达到撤销的效果。

git revert HEAD //撤销最近一次提交
git revert HEAD~1 //撤销上上次的提交，注意：数字从0开始
git revert 0ffaacc //撤销0ffaacc这次提交

git追踪文件夹/文件名称更新

git mv -f oldfolder newfolder
git add -u newfolder # (-u选项会更新已经追踪的文件和文件夹)
git commit -m "changed the foldername whaddup"
git push origin yourBranch

Git ssh 拉取报错

git pull 命令在尝试通过 SSH（端口 22）连接 Gitee 时失败了，原因是连接被拒绝。这通常是因为：

网络限制：你的网络环境（如公司、学校或某些地区的网络）可能屏蔽了 SSH 端口 22。
SSH 配置问题：SSH 服务未正确配置或未运行。

✅ 解决方案

修改远程仓库的 URL 为 HTTPS 地址：

git remote set-url origin https://gitee.com/你的用户名/你的仓库名.git

例如：

git remote set-url origin https://gitee.com/houfei/open-webui.git

再次尝试拉取：
```
git pull
```
第一次可能会提示你输入 Gitee 的用户名和密码（或个人访问令牌）。

🔐 注意：建议使用个人访问令牌（Personal Access Token）代替密码，更安全。

安装 Git​

推荐安装方法：使用 Homebrew​

其他安装方法​

配置 Git​

检查你的配置​

生成 SSH 密钥​

代码提交规范​

Git 命令​

删除提交错误的push​

Git ssh 拉取报错​

✅ 解决方案​