Git 与 GitHub 使用教程

# Ubuntu/Debian
sudo apt update
sudo apt install git

# macOS（已预装）
# Windows：官网下载 https://git-scm.com

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
git config --global init.defaultBranch main    # 默认分支名设为 main
git config --global --add --bool push.autoSetupRemote true  # push 时自动关联远程

git config --list
git config user.name

# 在现有项目目录初始化
cd ~/path/to/project
git init

# 克隆远程仓库（首次获取）
git clone https://github.com/username/repo.git
git clone git@github.com:username/repo.git   # SSH 方式（推荐）

git status        # 查看当前工作区状态
git status -s     # 简洁输出

# 添加文件到暂存区（staging area）
git add file.txt           # 添加单个文件
git add .                  # 添加所有变更
git add -A                 # 添加所有（包括删除）

# 提交到本地仓库
git commit -m "提交说明"

# 快捷方式：跳过 add 直接提交已跟踪文件
git commit -am "提交说明"

git log                        # 详细日志
git log --oneline              # 每条一行，简短显示
git log -5                     # 最近5条
git log --graph --oneline     # 带分支图

# 撤销工作区修改（未 add）
git checkout -- file.txt
git restore file.txt           # 新版写法

# 取消暂存（已 add，未 commit）
git reset HEAD file.txt
git restore --staged file.txt  # 新版写法

# 回退到某个提交（危险操作）
git reset --hard <commit-hash>

git branch                 # 查看本地分支
git branch -a              # 查看所有分支（含远程）
git branch new-feature     # 创建新分支
git checkout new-feature    # 切换到新分支
git switch new-feature      # 新版写法
git switch -c new-feature   # 创建并切换

# 合并分支
git checkout main           # 切回主分支
git merge new-feature       # 将 new-feature 合并进来

# 删除分支
git branch -d new-feature   # 删除已合并的分支
git branch -D new-feature   # 强制删除未合并的分支

# 常见命名规范
feature/xxx        # 新功能
fix/xxx           # 修复
docs/xxx         # 文档

git remote add origin https://github.com/username/repo.git
# 或 SSH 方式（推荐，无需每次输入密码）
git remote add origin git@github.com:username/repo.git

git remote -v                   # 查看远程仓库地址
git remote set-url origin <url>  # 修改远程地址

git push                        # 推送到远程（首次推送后 push.autoSetupRemote 会自动关联）
git push -u origin main          # 首次推送并追踪分支
git push origin main             # 推送到 main 分支
git push -f                      # 强制推送（慎用，会覆盖远程历史）

git pull                        # 拉取并合并远程变更
git fetch                       # 仅拉取，不合并

ssh-keygen -t ed25519 -C "你的邮箱"
# 一路回车，使用默认路径 ~/.ssh/id_ed25519

cat ~/.ssh/id_ed25519.pub
# 或
cat ~/.ssh/id_rsa.pub

ssh -T git@github.com
# 出现 "Hi username! You've successfully authenticated" 即成功

git clone git@github.com:username/repo.git
git remote add origin git@github.com:username/repo.git

# 1. 开始新任务前，先拉最新代码
git switch main
git pull

# 2. 创建新分支
git switch -c feature/xxx

# 3. 开发、修改、提交
git add .
git commit -m "完成功能 xxx"

# 4. 推送到远程
git push -u origin feature/xxx

# 5. 在 GitHub 上发起 Pull Request（合并请求）
# 6. 合并后切回主分支
git switch main
git pull

# 进入笔记目录
cd ~/study/lc

# 添加所有变更
git add .

# 提交（仅当有变更时）
if git diff --staged --quiet; then
    echo "没有变更"
else
    git commit -m "同步：$(date '+%Y-%m-%d %H:%M')"
    git push
fi

# crontab -e 添加
*/30 * * * * cd ~/study/lc && git add . && git diff --staged --quiet || git commit -m "auto-sync $(date '+\%Y-\%m-\%d \%H:\%M')" && git push

# 在仓库根目录创建 .gitignore
touch .gitignore

# 示例内容
.obsidian/           # Obsidian 配置（个人偏好不同）
.trash/              # 回收站
*.log                # 日志文件
.DS_Store            # macOS 系统文件
node_modules/         # npm 包
__pycache__/         # Python 缓存
*.tmp                # 临时文件
.vscode/             # VSCode 配置（可选）

# 如果已经提交过的文件需要忽略
git rm --cached filename    # 先从仓库移除
# 再加入 .gitignore

# 拉取远程时发现冲突
git pull

# 手动解决冲突后
git add resolved-file.txt
git commit -m "解决冲突"
git push

git reset --soft HEAD~1     # 保留修改，仅撤销 commit
git reset --hard HEAD~1     # 撤销 commit 并删除修改（危险）

git remote -v

git tag v1.0.0              # 创建轻量标签
git tag -a v1.0.0 -m "版本1.0"   # 创建附注标签
git push origin v1.0.0       # 推送标签到远程

git blame file.txt