Git
git 由 linus 开发。
Git流程图
- clone(克隆): 从远程仓库中克隆代码到本地仓库
- checkout(检出):从本地仓库中检出一个仓库分支然后进行修订
- add(添加):在提交前先将代码提交到暂存区
- commit(提交):提交到本地仓库,本地仓库中保存修改的各个历史版本
- fetch(抓取):从远程库,抓取到本地仓库,不进行任何的合并动作,一般操作比较少。
- pull(拉取):从远程库拉到本地库,自动进行合并(merge),然后放到工作区,相当于fetch + merge
- push(推送):修改完成后,需要和团队成员共享代码时,将代码推送到远程仓库
Git基本配置
git config --global user.name "xxx"
git config --global user.email "xxx@gmail.com"
git config --global user.name
git config --global user.email
给一些长命令起别名:
在 ~/.bashrc 中添加:
alias git-log='git log --pretty=oneline --all --graph --abbrev-commit'
alias ll='ls -al'
之后 source ~/.bashrc 使其生效。
新建代码库
# 在当前目录新建一个git代码库
$ git init
# 新建一个目录,将其初始化为git代码库
$ git init [project-name]
# 下载一个项目和它的整个代码历史
$ git clone [url]
配置
git的设置文件为 .gitconfig ,它可以在用户主目录下(全局配置),也可以在项目目录下(项目配置)。
# 显示当前的git配置
$ git config --list
#编辑git配置文件
$ git config -e [--global]
#设置提交代码时的用户信息
$ git config [--global] user.name "[name]"
$ git config [--global] user.name "[email address]"
增加/删除文件
# 添加指定文件到暂存区
$ git add [file1] [file2]
# 添加指定目录到暂存区,包括子目录
$ git add [dir]
# 添加当前目录的所有文件到暂存区
$ git add .
# 添加每个变化前,都会要求确认
# 对于同一个文件的多处变化,可以实现分次提交
$ git add -p
# 删除工作区文件,并且将这次删除放入暂存区
$ git rm [file1] [file2]
# 停止追踪指定文件,但该文件会保留在工作区
$ git rm --cached [file]
# 改名文件,并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]
代码提交
# 提交暂存区到仓库区
$ git commit -m [message]
# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] [file3] ... -m [message]
# 提交工作区自上次commit之后的变化,直接到仓库区
$ git commit -a
# 提交时显示所有diff信息
$ git commit -v
# 使用一次新的commit,替代上一次提交
# 如果代码没有任何新变化,则用来改写上一次commit的提交信息
$ git commit --amend -m [message]
# 重做上一次commit,并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...
版本切换:
git reset --hard commitId
查看所有日志:
git reflog
换行符(LF & CRLF)
它控制着在提交和检出文件时是否自动地将行结束符转换为不同的格式。
git config --global core.autocrlf false
查看当前项目是由哪个.git目录管理的
方法一:使用 git rev-parse --show-toplevel
git rev-parse --show-toplevel
这条命令会输出 Git 仓库的根目录,即 .git 所在目录。
/home/kenn/Projects/my-project
方法二:查看 .git 目录的路径
git rev-parse --git-dir
这条命令直接输出 .git 目录的路径:
- 如果输出是
.git,说明当前目录(或上层)就有.git文件夹。 - 如果是类似
.git是一个文件(子模块或工作区配置),则它可能是一个指向真实.git的路径(Git 工作树结构)。
代理
git config --global http.sslVerify "false"
设置代理
git config --global http.proxy http://127.0.0.1:端口号
git config --global http.proxy http://127.0.0.1:10809
git config --global https.proxy http://127.0.0.1:10809
取消代理
临时取消全局代理设置
git config --global --unset http.proxy
git config --global --unset https.proxy
仅对当前仓库禁用代理
git config --local http.proxy ""
git config --local https.proxy ""
通过环境变量临时禁用(适用于当前终端会话)
set HTTP_PROXY=
set HTTPS_PROXY=
临时取消代理
直接使用无代理克隆(推荐)
git -c http.proxy= clone https://huggingface.co/XiaomiMiMo/MiMo-7B-RL
恢复与撤销 (Reset, Revert, Rebase)
1. 撤销/回滚操作速查表
| 场景需求 | 核心命令 | 历史保留情况 | 适用范围 |
|---|---|---|---|
| 撤销最新一次提交,修改保留在暂存区 | git reset --soft HEAD~1 | 仅丢弃最新 commit,保留历史 | 本地未推送 |
| 撤销最新一次提交,修改保留在工作区 | git reset HEAD~1 | 仅丢弃最新 commit,保留历史 | 本地未推送 |
| 彻底回退到指定提交,丢弃后续所有改动 | git reset --hard <commit_id> | 抹去该提交之后的所有历史 | 本地未推送 |
| 安全撤销历史中某次提交,生成反向修改 | git revert <commit_id> | 追加新提交以撤销,完整保留历史 | 已推送/多人协作 |
| 彻底删除历史中某次提交,改写提交历史 | git rebase -i <commit_id>^ 并设为 drop | 丢弃特定 commit,修改历史 hash | 本地未推送 |
| 撤销历史中某次提交,但保留修改到暂存区/工作区 | git rebase -i <commit_id>^ 并设为 edit | 丢弃特定 commit,提取修改到本地 | 本地未推送 |
2. 核心操作步骤
撤销最近一次提交 (HEAD)
- 保留在暂存区 (可直接再次 commit):
git reset --soft HEAD~1 - 保留在工作区 (需重新 git add):
git reset HEAD~1
撤销历史中指定的某个提交
- 追加反向提交(不改写历史,安全):
git revert <commit_id> # 自动生成撤销 commit 并提交 git revert -n <commit_id> # 撤销改动并保留在暂存区,不自动生成 commit - 使用交互式变基(改写历史,仅限本地未推送分支):
git rebase -i <commit_id>^- 直接删除:将对应行前面的
pick改为drop(或删掉该行) -> 保存并退出。 - 提取修改:将对应行前面的
pick改为edit-> 保存退出 -> 暂停时运行git reset HEAD~1(或--soft) -> 运行git rebase --continue。
- 直接删除:将对应行前面的
找回误删的提交
git reflog # 查找被删除 commit 的哈希值(如 abc1234)
git reset --hard abc1234 # 将分支强制指向该提交
3. 避坑指南:撤销“新建文件”的 Commit,但后续 Commit 已修改该文件,会怎样?
若 Commit A 新建了 foo.txt,而后续 Commit B 修改了 foo.txt,撤销 Commit A 会因为“文件依赖丢失”而产生冲突。
- 使用 revert 撤销:
- 现象:提示
modify/delete冲突。 - 解决:编辑冲突,决定是彻底删除文件还是保留后续修改,再运行
git add和git revert --continue。
- 现象:提示
- 使用 rebase drop 撤销:
- 现象:应用 Commit B 时报错并中断,因为找不到要修改的
foo.txt。 - 解决:手动处理冲突(如
git rm foo.txt放弃该文件修改,或把文件重新丢回暂存区),再运行git rebase --continue。
- 现象:应用 Commit B 时报错并中断,因为找不到要修改的
- 使用 rebase edit 撤销:
- 现象:在 Commit A 处暂停并运行
git reset HEAD~1会将文件改动放回工作区。 - 注意:必须先重新提交该文件(可以是修改后的版本),使文件存在于历史中,再运行
git rebase --continue;否则后续 Commit B 应用时依旧会报错冲突。
- 现象:在 Commit A 处暂停并运行
分支
查看本地分支
git branch
创建本地分支
git branch 分支名
切换分支
git checkout 分支名
切换并创建分支
git checkout -b 分支名
合并分支
git merge
删除分支
删除分支时,需要做各种检查
git branch -d b1
不做任何检查,强制删除
git branch -D b1
解决冲突
git merge 需要合并的工作区
远程仓库
git push -f --set-upstream [远端名称[本地分支名][:远端分支名]]
git remote add origin 源
源管理
查看源
git remote -v
只查看 origin 的 URL
git remote get-url origin
更改远程仓库的 URL
git remote set-url origin 新的仓库地址
添加多个源
git remote add origin2 https://github.com/username/other-repo.git
删除源
git remote remove origin2
设置本地分支与远端分支绑定
git push --set-upstream origin main
或者-u 会设置 upstream
设置好之后,直接
git push
克隆
git clone 地址
从远程仓库抓取和拉取
抓取,将仓库里的更新都抓取到本地,但不会进行合并
git fetch [remote name] [branch name]
拉取,就是将远端仓库的修改拉到本地并自动进行合并,等同于 fetch + merge
git pull [remote name] [branch name]
解决合并冲突
在 Git 中,合并冲突通常发生在你尝试将一个分支的修改合并到另一个分支时,且这些分支修改了相同的文件和行。Git 无法自动合并这些冲突,需要手动干预来解决。
远程有本地没有的提交,同时本地也有提交(或者改动)
方法一:先拉,再推
bashCopyEditgit pull --rebase origin main
git push -u origin main
方法二:放弃远程的 main,强推
git push -f origin main
方法三:创建一个新分支然后提 Merge Request
bashCopyEditgit checkout -b my_main_v1
git push -u origin my_main_v1
处理代码本地改动
提交
git add .
git commit -m "本地修改:提交前pull"
git pull --rebase origin main
git push -u origin main
暂时存起来
git stash
git pull --rebase origin main
git stash pop
git push -u origin main
解决 Git 合并冲突的步骤:
触发合并冲突
通常,合并冲突在你执行
git merge或git rebase时发生。例如,如果你正在将feature分支合并到main分支:git checkout main git merge feature如果有冲突,Git 会停止合并,并输出类似以下的信息:
Auto-merging <file> CONFLICT (content): Merge conflict in <file>查看哪些文件有冲突
使用
git status查看哪些文件存在冲突:git statusGit 会列出有冲突的文件,通常显示为 “both modified”。
例如:
both modified: example.txt打开并解决冲突
打开有冲突的文件(例如
example.txt),你会看到类似下面的内容:<<<<<<< HEAD 这是 main 分支的内容 ======= 这是 feature 分支的内容 >>>>>>> feature<<<<<<< HEAD和=======之间是当前分支(HEAD)的内容。=======和>>>>>>> feature之间是要合并的分支(feature)的内容。
你需要手动修改这些冲突部分,选择保留哪个内容,或者进行合并。例如,可能会修改为:
这是合并后的内容,包含了 main 和 feature 分支的修改。解决完冲突后,删除标记 (
<<<<<<<,=======,>>>>>>>),并保存文件。标记文件为已解决
解决冲突并保存文件后,使用
git add将文件标记为已解决:git add example.txt完成合并
一旦所有冲突都解决并标记为已解决,你可以提交合并:
git commit如果是合并操作,Git 会自动生成一个合并提交信息,你可以修改这个信息,或者直接保存并提交。
查看合并结果
使用
git status确认冲突已解决,工作树干净,合并已完成:git status如果一切正常,Git 会显示如下:
On branch main nothing to commit, working tree clean
推送
推送所有本地分支
git push --all
强推
git push --force origin main
使用 --force-with-lease 替代 --force
为了避免强推造成的潜在数据丢失问题,可以使用 --force-with-lease 代替 --force。这个命令可以确保你仅在远程仓库的分支没有新的提交时进行强推,否则会拒绝推送,避免覆盖其他人的提交。
git push --force-with-lease
修改 commit 的 message
1. 修改最近一次的 commit message
使用
--amend:git commit --amend -m "新的提交信息"这条命令会替换最近一次的 commit message。
2. 修改更早的 commit message
如果需要修改更早的 commit message,可以使用 rebase 命令:
启动交互式 rebase:
git rebase -i HEAD~n其中
n是你想要回溯的提交数量。在打开的文本编辑器中找到要修改的 commit,将
pick改为reword(或r)。保存并退出编辑器,接着会弹出一个新的编辑器窗口,你可以在这里修改 commit message。
保存并关闭编辑器,完成后 Git 将会应用修改。
SSH配置
1. 生成 SSH 密钥
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
解释:
-t rsa:指定使用 RSA 算法生成密钥。-b 4096:指定密钥的长度为 4096 位,越长的密钥越安全。-C:添加一个注释,通常用来标识密钥的用途(例如你的电子邮件地址)。
- 接下来,系统会提示你选择密钥保存位置。默认情况下,SSH 密钥会保存在
~/.ssh/id_rsa(Linux 和 macOS)或C:\Users\<YourUsername>\.ssh\id_rsa(Windows)中。直接按 Enter 即可使用默认位置。 - 你会被要求输入一个密钥的 密码。这个密码是可选的,如果设置了密码,每次使用 SSH 密钥时需要输入密码,增加安全性。
- 完成后,SSH 密钥对将会生成:
- 公钥:
~/.ssh/id_rsa.pub - 私钥:
~/.ssh/id_rsa
- 公钥:
2. 将 SSH 公钥添加到 Git 服务器
将你生成的公钥添加到 Git 服务器(如 GitHub、GitLab 或 Bitbucket)以便验证你的身份。这里以 GitHub 为例:
复制 SSH 公钥:
使用以下命令将公钥复制到剪贴板(Linux/macOS):
cat ~/.ssh/id_rsa.pub可以手动复制输出的公钥,或者在 macOS 上使用
pbcopy(Windows 上可以直接打开文件并复制):pbcopy < ~/.ssh/id_rsa.pub # macOS对于 Windows,可以直接打开
~/.ssh/id_rsa.pub文件,并复制内容。将公钥添加到 GitHub:
- 登录到你的 GitHub 账户。
- 进入 Settings(设置) > SSH and GPG keys > New SSH key。
- 将刚刚复制的公钥粘贴到 Key 字段中,并为该密钥设置一个合适的标题(例如:
My Laptop)。 - 点击 Add SSH key。
3. 测试 SSH 连接
确保一切配置正确后,运行以下命令来测试 SSH 是否连接成功:
ssh -T git@github.com
如果你使用的是 GitHub,这条命令应该返回类似以下的信息:
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
如果返回成功信息,则说明 SSH 配置成功。
4. 配置 Git 使用 SSH URL
现在,你已经成功配置了 SSH 密钥,并将其添加到 GitHub 账户。接下来,确保 Git 使用 SSH 协议而非 HTTPS 协议进行操作。
克隆仓库时使用 SSH URL:
git clone git@github.com:username/repository.git更改现有仓库的远程 URL 为 SSH:
如果你已经克隆了一个仓库,但它是使用 HTTPS URL,想改成 SSH URL,可以使用以下命令:
git remote set-url origin git@github.com:username/repository.git这样,之后所有
git push和git pull操作都会通过 SSH 进行。
5. 常见问题
无法连接到 Git 服务器:确认公钥已正确添加到服务器,并检查防火墙或代理设置是否阻止了 SSH 连接。
密钥权限问题:确保你的私钥文件权限正确(
~/.ssh/id_rsa应该是 600 权限):chmod 600 ~/.ssh/id_rsa使用多个 Git 账户:如果你有多个 Git 账户(例如,一个用于工作,一个用于个人项目),你可以通过在
~/.ssh/config文件中配置不同的密钥来区分不同的账户。
# Default GitHub Account (for personal use)
Host github.com
User git
HostName github.com
IdentityFile ~/.ssh/id_rsa_github_personal
# Work GitHub Account (for work use)
Host github-work.com
User git
HostName github.com
IdentityFile ~/.ssh/id_rsa_github_work
IdentitiesOnly yes
# GitLab Personal Account
Host gitlab.com
User git
HostName gitlab.com
IdentityFile ~/.ssh/id_rsa_gitlab_personal
IdentitiesOnly yes
IdentityFile:指定用于 SSH 连接的密钥文件。IdentitiesOnly yes:确保只有你指定的密钥会被使用,避免其他默认密钥的干扰。
使用配置的 Git 操作:
克隆仓库时指定
Host:你可以使用配置中指定的
Host来轻松地选择要使用的远程仓库。例如,假设你要克隆 GitHub 个人账户的仓库,你可以使用如下命令:git clone git@github.com:username/repository.git对于工作 GitHub 账户,可以使用:
git clone git@github-work.com:username/repository.git对于 GitLab 和 Bitbucket 也同理。
推送到远程仓库时:
当你执行
git push或git pull时,Git 会自动选择相应的 SSH 密钥。
Git Bash
git bash 设置home目录
setx HOME "C:\Projects"
.gitignore
检查.gitignore 是否设置生效
git check-ignore -v .idea

