Git

Git 常用命令记录

安装 Install

Linux 搭建 Git 服务器及后续更新:

参考:

基础 Basic

示例中的 <placeholder-name> 是占位符,使用小写字母和连字符命名。执行前请将整个占位符(包括尖括号)替换为实际值,并保留 Shell 命令中的引号,避免尖括号被解释为重定向。

最常用的 Git 操作命令:

git status                       # 查看当前仓库状态 (变更、未暂存、未提交等)
git add .                        # 添加所有变更到暂存区
git commit -m "<commit-message>" # 提交到本地仓库
git push                         # 推送到远程仓库
git pull                         # 拉取远程仓库最新代码
git log                          # 查看提交历史
git diff                         # 比较变更内容
git reflog                       # 查看所有操作记录 (包括回滚、reset 等)

说明:

  • git reflog 可用于找回误删的分支和提交。
  • git log --oneline 可简洁显示历史记录。

参考: Git 基础操作

克隆 Clone

大仓库可按需选择部分克隆或浅克隆。两种方式都能检出当前版本的完整文件,但省略的数据不同。

部分克隆

保留所获取分支的完整提交历史,按需下载文件内容:

git clone --filter=blob:none "<repository-url>"
  • blob 是 Git 存储文件内容的对象。初次获取时省略这些对象,检出时再下载当前版本所需的内容。
  • 查看历史文件内容时,Git 可能需要联网补充下载。
  • 提交和目录结构仍需下载,因此初始下载量可能较大。远程服务器需支持过滤功能。

浅克隆

仅获取最新一层提交历史,适合阅读或构建最新源码:

git clone --depth 1 "<repository-url>"

默认只获取一个分支。浅克隆仍可编辑和提交,但依赖完整历史的操作会受限。

进入克隆后的仓库,按需选择以下命令补充历史:

# 从当前浅克隆边界继续获取 100 层历史
git fetch --deepen=100

# 远程仓库历史完整时,补全所配置分支的历史
git fetch --unshallow

--unshallow 不会自动扩大获取分支的配置。补全历史不等于获取所有远程分支。

参考:

配置 Config

用户名和邮箱

查看和修改用户名及邮箱:

# 查看
git config user.name
git config user.email

# 修改
git config --global user.name "<username>"
git config --global user.email "<email>"

针对不同项目修改用户名和邮箱:

git config user.name "<username>"
git config user.email "<email>"

参考:

本地忽略文件

只在当前本地仓库忽略文件,无需修改共享的 .gitignore。在普通克隆仓库的根目录执行:

echo "<ignore-pattern>" >> .git/info/exclude

例如,忽略未跟踪的 AGENTS.md:

echo "AGENTS.md" >> .git/info/exclude
  • .git/info/exclude 不纳入版本控制,规则不会随提交共享。
  • 规则使用 .gitignore 的模式语法。AGENTS.md 可匹配各级目录中的同名文件;/AGENTS.md 只匹配仓库根目录。
  • 忽略规则不影响已经跟踪的文件,也不会自动取消跟踪。
  • 上述路径适用于 .git 为目录的普通克隆,不适用于 .git 为文件的链接工作树。

如果需要先重命名文件,可单独执行 mv AGENTS.log.md AGENTS.md。执行前确认目标文件不存在,避免覆盖。重命名与设置忽略规则是两个独立操作。

参考: Git ignore 官方文档

权限 Access Credential

添加 SSH Keys 到远程平台:

ED25519 (推荐):

cd ~ && ssh-keygen -t ed25519 -C "<email>" && cd ~/.ssh && cat id_ed25519.pub

RSA:

cd ~ && ssh-keygen -t rsa -C "<email>" && cd ~/.ssh && cat id_rsa.pub

参考: GitHub / Gitee 等托管平台添加 SSH Keys

缓存 Cache

更新忽略文件 .gitignore 后清理缓存:

git rm -r --cached . && git add . && git commit -m "chore: clean cache" && git push

参考: Git 删除 .gitignore 生成之前上传的文件

仓库地址 Remote Repository

修改远程仓库地址:

git remote set-url origin "<repository-url>"

参考: Git 修改远程地址

分支 Branch

删除本地和远程分支:

git branch -d "<branch-name>"
git push origin --delete "<branch-name>"

参考: Git 删除本地和远程分支

提交 Commit

修改最近一次 commit 的信息:

git commit --amend

查找第一条提交记录:

git rev-list --max-parents=0 HEAD
git show "<commit-hash>"

参考:

标签 Tag

创建标签并推送:

git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0

拉取 Pull

配置 git pull 的 Merge / Rebase 策略

当本地分支和远程分支出现分叉时,可配置 git pull 默认使用 Merge 或 Rebase,避免 Git 每次提示选择拉取策略。

使用 Merge:

git config --global pull.rebase false

保留分支原有提交历史,必要时会产生 Merge Commit。

使用 Rebase:

git config --global pull.rebase true

将本地提交重新应用到远程分支最新提交之后,使提交历史更加线性。

仅针对当前仓库配置时,移除 --global:

git config pull.rebase false
git config pull.rebase true

查看当前配置:

git config --get pull.rebase
git config --global --get pull.rebase

批量拉取

批量拉取指定文件夹下所有 Git 项目最新代码。

参考: 批量拉取 / git pull 指定文件夹下面所有 Git 项目的最新代码

开发 Development

npm 直接安装 GitHub / GitLab 仓库代码及 npm link 本地调试。

参考: npm 直接安装 GitHub / GitLab 仓库代码及 npm link 本地调试

极狐 GitLab

相关 CI / CD、部署与构建方案。

参考:

版权声明

本文为原创文章,作者保留版权。转载请保留本文完整内容,并以超链接形式注明作者及原文出处。

作者: 除除
原文: chengchuu.github.io/?p=5611