LoongLee's blog

Git使用指南

Git使用指南

来源

原始文档: git_use.md

核心内容

Git 版本控制系统常用操作和配置。

配置文件

# 全局配置位置
~/.gitconfig

子模块管理

# 添加子模块
git submodule add git@gitea:xxx.git src/path

# 初始化和同步
git submodule update --init --recursive

# 同步更新所有子模块
git submodule foreach git pull origin

# 同步更新指定子模块
git submodule update --remote submoule_path

# 删除子模块
# 1. 删除 .gitmodules 中的相关条目
# 2. 删除 .git/config 中的相关条目
# 3. 删除缓存: git rm --cached submodule_path
# 4. 删除文件: rm -rf submodule_path

凭证管理

# 临时缓存凭证(15分钟)
git config --global credential.helper cache

# 永久存储凭证
# ⚠️ 密码明文存储在 ~/.git-credentials
git config --global credential.helper store

自定义别名

# 显示提交信息和时间(短格式)
git config --global alias.glod 'log --pretty=format:"%ad %s" --date=short'

分支上游设置

问题: "当前分支没有对应的上游分支"

解决方案1: 使用 --set-upstream

git push --set-upstream origin master
# 或简写
git push -u origin master

解决方案2: 自动设置上游(推荐)

# 需要 Git 2.37+
git config --global push.autoSetupRemote true

设置完成后,后续可直接使用 git push 和 git pull。

关键要点

  • 子模块需要单独初始化和更新
  • 凭证助手 store 会明文存储密码,注意安全
  • push.autoSetupRemote 简化新分支推送流程
  • 上游分支建立后,Git 会自动跟踪远程分支

相关实体

  • Git - 分布式版本控制系统
  • GitHub - Git 托管平台
  • Gitea - 自托管 Git 服务
  • 版本控制 - 版本控制概念