1
2
3
4

# 在命令行中输入以下命令检查是否安装
git --version

# 如果没有安装，去 https://git-scm.com 下载安装

1
2
3
4
5
6
7
8
9

# 如果没有安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然后安装 Git
brew install git

# 验证安装
git --version
# 输出类似：git version 2.51.0

1
2
3

sudo apt update
sudo apt install git
git --version

1
2
3
4
5
6
7
8
9

# 创建项目文件夹
mkdir my-java-project
cd my-java-project

# 初始化 Git 仓库
git init

# 输出：
# Initialized empty Git repository in /path/to/my-java-project/.git/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 创建一个 Java 文件
cat > HelloGit.java << 'EOF'
/**
 * 我的第一个 Git 管理的 Java 文件
 * @author JavaLearner
 */
public class HelloGit {
    public static void main(String[] args) {
        System.out.println("Hello, Git! 我的代码被版本控制了！");
    }
}
EOF

# 查看当前 Git 状态
git status

# 输出：
# On branch master
#
# No commits yet
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#   HelloGit.java

1
2
3
4
5
6
7
8
9

# 添加文件到暂存区
git add HelloGit.java

# 再次查看状态
git status
# 输出：
# Changes to be committed:
#   (use "git rm --cached <file>..." to undo)
#   new file:   HelloGit.java

1
2
3
4
5
6
7
8

# 提交到本地仓库
# -m 参数后面是提交说明，必须填写，且要写得有意义！
git commit -m "feat: 添加 HelloGit 示例类"

# 输出：
# [master (root-commit) a1b2c3d] feat: 添加 HelloGit 示例类
#  1 file changed, 9 insertions(+)
#  create mode 100644 HelloGit.java

1
2
3
4
5
6
7
8
9

# 查看提交历史
git log

# 输出：
# commit a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0 (HEAD -> master)
# Author: JavaLearner <java@example.com>
# Date:   Mon Mar 30 21:00:00 2026 +0800
#
#     feat: 添加 HelloGit 示例类

1
2
3
4

git log --oneline

# 输出：
# a1b2c3d feat: 添加 HelloGit 示例类

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 修改 HelloGit.java
cat > HelloGit.java << 'EOF'
/**
 * 我的第一个 Git 管理的 Java 文件（已更新）
 * @author JavaLearner
 */
public class HelloGit {
    public static void main(String[] args) {
        System.out.println("Hello, Git!");
        System.out.println("这是我的第二次修改！");
        // 添加了一个新功能
        sayGoodbye();
    }

    public static void sayGoodbye() {
        System.out.println("Goodbye, Git!");
    }
}
EOF

# 查看文件差异
git diff HelloGit.java

1
2
3

# 提交这次修改
git add HelloGit.java
git commit -m "feat: 添加 sayGoodbye 方法，完善输出功能"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 场景1：文件修改了，但还没 add，想撤销
git checkout -- HelloGit.java
# 或者（新版本 Git 语法）
git restore HelloGit.java

# 场景2：文件 add 了，但还没 commit，想撤销（回到工作区）
git reset HEAD HelloGit.java
# 或者
git restore --staged HelloGit.java

# 场景3：已经 commit 了，想回到上一个版本
git reset --hard HEAD^
# 注意：^表示上一个版本，^^表示上上一个版本，或者用 HEAD~1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 创建 .gitignore 文件
cat > .gitignore << 'EOF'
# 编译生成的 class 文件
*.class

# IDE 配置文件
.idea/
*.iml
.vscode/

# 日志文件
*.log

# Maven/Gradle 构建目录
target/
build/

# 系统文件
.DS_Store
Thumbs.db
EOF

# 查看被忽略的文件状态
git status --ignored

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 查看当前所有分支（* 表示当前所在分支）
git branch

# 输出：
# * master
#   只有 master 一个分支

# 创建新分支
git branch feature-login

# 切换到新分支
git checkout feature-login
# 或者（新版本 Git）
git switch feature-login

# 输出：
# Switched to branch 'feature-login'

# 再次查看分支
git branch
# 输出：
# * feature-login
#   master

1
2
3
4

# 创建并切换（常用）
git checkout -b feature-register
# 或者
git switch -c feature-register

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# 确保在 feature-login 分支
git checkout feature-login

# 创建一个登录相关的 Java 类
mkdir -p com/example/auth
cat > com/example/auth/LoginService.java << 'EOF'
package com.example.auth;

/**
 * 登录服务类
 */
public class LoginService {
    private String username;
    private String password;

    public LoginService(String username, String password) {
        this.username = username;
        this.password = password;
    }

    /**
     * 执行登录验证
     * @return 登录是否成功
     */
    public boolean login() {
        // 简单的验证逻辑
        if (username != null && password != null) {
            System.out.println("用户 " + username + " 登录成功！");
            return true;
        }
        System.out.println("登录失败：用户名或密码错误！");
        return false;
    }
}
EOF

# 添加并提交
git add .
git commit -m "feat: 添加登录服务类"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 1. 先切换回主分支
git checkout master
# 或者
git switch master

# 2. 合并 feature-login 分支
git merge feature-login

# 输出：
# Merge made by the 'ort' strategy.
#  1 file changed, 28 insertions(+)
#  create mode 100644 com/example/auth/LoginService.java

1
2
3
4
5
6
7
8

# 删除已合并的分支
git branch -d feature-login

# 输出：
# Deleted branch feature-login (was abc1234).

# 如果分支还没合并，强制删除
git branch -D feature-register

1
2
3
4
5
6
7

# 假设在合并时出现冲突
git merge feature-conflict

# 输出：
# Auto-merging HelloGit.java
# CONFLICT (content): Merge conflict in HelloGit.java
# Automatic merge failed; fix conflicts and then commit the result.

1
2
3
4
5
6
7
8
9

<<<<<<< HEAD
    public static void main(String[] args) {
        System.out.println("主分支的代码");
    }
=======
    public static void main(String[] args) {
        System.out.println("功能分支的代码");
    }
>>>>>>> feature-conflict

1
2
3
4
5

# 添加解决后的文件
git add HelloGit.java

# 完成合并提交
git commit -m "merge: 解决与 feature-conflict 的冲突，保留两处修改"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 暂存当前未提交的工作
git stash

# 输出：
# Saved working directory and index state WIP on master: abc1234 feat: 添加 HelloGit

# 切换分支干活
git checkout hotfix-branch
# ... 修 bug ...

# 修完后回到原分支
git checkout master

# 恢复之前的工作
git stash pop

# 输出：
# Dropped refs/stash@{0} (a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 1. 检查是否已有 SSH 密钥
ls -la ~/.ssh

# 2. 生成新的 SSH 密钥（替换为你的邮箱）
ssh-keygen -t ed25519 -C "your_email@example.com"

# 输出：
# Generating public/private ed25519 key pair.
# Enter file in which to save the key (~/.ssh/id_ed25519):
# Enter passphrase (empty for no passphrase):
# Enter same passphrase again:

# 3. 查看公钥内容
cat ~/.ssh/id_ed25519.pub
# 输出类似：ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... your_email@example.com

# 4. 复制公钥，添加到 GitHub：
#    Settings -> SSH and GPG keys -> New SSH key -> 粘贴公钥

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 克隆你刚创建的仓库（替换为你的仓库地址）
git clone git@github.com:yourusername/my-java-project.git

# 输出：
# Cloning into 'my-java-project'...
# remote: Enumerating objects: done.
# remote: Counting objects: done.
# remote: Compressing objects: done.
# Receiving objects: 100%, done.

# 进入项目目录
cd my-java-project

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# 添加远程仓库地址（origin 是远程仓库的默认名称）
git remote add origin git@github.com:yourusername/my-java-project.git

# 查看远程仓库信息
git remote -v

# 输出：
# origin  git@github.com:yourusername/my-java-project.git (fetch)
# origin  git@github.com:yourusername/my-java-project.git (push)

# 推送代码到远程仓库的 master 分支
# -u 参数设置上游分支，以后可以直接用 git push
git push -u origin master

# 输出：
# Enumerating objects: 3, done.
# Counting objects: 100%, done.
# Writing objects: 100%, done.
# remote: Resolving deltas: done.
# To github.com:yourusername/my-java-project.git
#    abc1234..def5678  master -> master

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# 假设你想参与一个开源项目
# 1. 在 GitHub 上 Fork 这个项目到你的账号

# 2. 克隆你 Fork 后的仓库
git clone git@github.com:yourusername/some-open-source-project.git

# 3. 创建自己的功能分支
git checkout -b fix-bug-123

# 4. 修改代码并提交
# ... 编辑文件 ...
git add .
git commit -m "fix: 修复了某个bug"

# 5. 推送到你的 GitHub 仓库
git push -u origin fix-bug-123

# 6. 在 GitHub 上创建 Pull Request
#    点击 "Compare & pull request" 按钮，填写说明，然后提交

1
2
3
4
5
6

# 拉取远程更新并合并
git pull origin master

# 或者分两步走
git fetch origin      # 获取远程更新（不合并）
git merge origin/master  # 合并到当前分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 创建轻量标签
git tag v1.0.0-rc1

# 创建附注标签（推荐，包含更多信息）
git tag -a v1.0.0 -m "第一个正式版本"

# 查看所有标签
git tag

# 推送标签到远程
git push origin v1.0.0

# 或者推送所有标签
git push origin --tags

1
2
3
4
5

# macOS 用钥匙串保存凭据
git config --global credential.helper osxkeychain

# Linux
git config --global credential.helper store

1
2
3
4

feature/user-login      # 新功能
fix/checkout-bug       # 修复 bug
hotfix/critical-error  # 紧急修复
release/v1.0.0         # 发布版本

1
2
3
4
5
6
7

feat: 添加用户登录功能
fix: 修复购物车结算金额错误
docs: 更新 README 文档
style: 格式化代码（不影响功能）
refactor: 重构代码（不影响功能）
test: 添加单元测试
chore: 构建或辅助工具的变动

1
2
3
4
5
6
7
8
9

# 1. 看看 HEAD 最近都去过哪里
git reflog
# 输出形如：
# a1b2c3d HEAD@{0}: reset: moving to HEAD^
# d4e5f6a HEAD@{1}: commit: feat: 添加订单校验   <-- 就是这次被 reset 掉了

# 2. 把丢失的提交捡回来（两种方式选一种）
git branch rescue d4e5f6a     # 方式一：新建一个分支指向它，安全
git reset --hard d4e5f6a      # 方式二：直接让当前分支回到那次提交

1
2
3
4
5

# 把本地还没推送的提交"挪到"远程最新提交之后，时间线是一条直线
git pull --rebase

# 让它成为默认行为（推荐）
git config --global pull.rebase true

1
2
3
4
5
6

# .gitattributes：让仓库里统一存 LF，检出到工作区时按平台自动转换
* text=auto
*.java text eol=lf
*.sh   text eol=lf
*.bat  text eol=crlf
*.png  binary

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# 初始化与配置
git init                    # 初始化仓库
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

# 基本操作
git add <文件>              # 添加到暂存区
git commit -m "消息"        # 提交到仓库
git status                  # 查看状态
git log                     # 查看历史
git diff                    # 查看差异

# 分支操作
git branch                  # 查看分支
git branch <分支名>         # 创建分支
git switch <分支名>         # 切换分支（推荐，Git 2.23+）
git switch -c <分支名>      # 创建并切换
git merge <分支名>          # 合并分支
git branch -d <分支名>      # 删除分支

# 撤销与恢复
git restore <文件>              # 丢弃工作区改动（危险）
git restore --staged <文件>     # 从暂存区撤出，保留工作区改动
git reflog                      # 查看 HEAD 的移动轨迹，最后一道保险

# 远程操作
git remote add origin <URL> # 添加远程仓库
git clone <URL>             # 克隆仓库
git push                    # 推送
git pull                    # 拉取
git fetch                   # 获取更新

# 其他
git stash                   # 储藏工作
git tag v1.0.0              # 创建标签