Windows 下 Git 常规操作：命令行与 TortoiseGit

使用命令行 (为当前项目)

1. 打开终端：在您的项目文件夹中，启动 PowerShell 或 Git Bash。
2. 验证配置：在该项目目录下运行 git config user.name 和 git config user.email 可以查看当前项目设置好的用户信息。

执行命令：运行以下两条命令（注意没有 --global 参数），即可为当前项目设置用户信息。

git config user.name "Your Name For This Project"
git config user.email "[email protected]"

2. 克隆 (Clone) - 将远程项目复制到本地

克隆操作用于将一个远程 Git 仓库完整地复制到您的电脑上，创建一份本地副本。

使用 TortoiseGit 克隆

1. 复制仓库地址：首先，在 Git 托管平台（如 GitHub, GitLab, Gitee）上找到您想要克隆的项目的仓库地址（通常以 .git 结尾），并复制它。
2. 打开克隆对话框：在您希望存放项目的文件夹空白处，点击鼠标右键，在弹出的菜单中选择 Git 克隆 (C)... (Git Clone…)。
3. 填写信息：
   • URL: 粘贴您刚刚复制的仓库地址。
   • 目录 (Directory): TortoiseGit 会自动根据仓库名填充一个本地目录名，您也可以修改为您希望的路径。
   • 其他选项通常保持默认即可。
4. 执行克隆：点击'确定'按钮。TortoiseGit 会开始下载仓库内容，完成后您会在指定位置看到一个新的项目文件夹。

使用命令行克隆

1. 打开终端：在您希望存放项目的文件夹中，点击鼠标右键，选择'在终端中打开'或类似的选项，启动 PowerShell 或 Git Bash。

执行命令：输入 git clone 命令，并在后面跟上您复制的仓库地址，然后按回车。

git clone https://github.com/example/project.git

Git 会开始下载仓库，并在当前目录下创建一个与项目同名的文件夹。

3. 更新 (Pull) - 同步远程仓库的最新代码

当远程仓库有新的提交时，您需要通过'拉取'操作来更新本地代码，以保持与团队同步。

使用 TortoiseGit 拉取

1. 进入您的项目文件夹。
2. 在文件夹空白处点击右键（或直接在文件夹图标上右键），选择 TortoiseGit -> 拉取 (P)... (Pull…)。
3. 在弹出的对话框中，通常无需修改任何设置，直接点击'确定'。
4. TortoiseGit 会自动抓取（Fetch）远程最新的改动并将其合并（Merge）到您当前的分支。

使用命令行拉取

执行命令：运行 git pull 命令。

git pull

Git 会自动从远程仓库拉取最新的变更并与您本地的分支合并。

进入项目目录：首先，使用 cd 命令进入您的项目文件夹。

cd path/to/your/project

4. 查看日志 (Log) - 浏览项目的提交历史

查看日志是了解项目变更历史、追溯代码修改的重要途径。

使用 TortoiseGit 查看日志

1. 在项目文件夹的空白处点击右键（或直接在文件夹图标上右键）。
2. 选择 TortoiseGit -> 显示日志 (L) (Show log)。
3. 日志窗口会列出所有的提交记录，从最新到最旧。您可以：
   • 点击任意一条记录，查看该次提交修改了哪些文件。
   • 在下方文件列表中双击某个文件，可以具体查看修改的内容。
   • 看到清晰的分支演进图。

使用命令行查看日志

1. 进入项目目录：确保您的终端位于项目文件夹内。

执行命令：运行 git log 命令。

git log

终端会按时间顺序列出所有提交记录，包含提交哈希值、作者、日期和提交信息。按 q 键退出日志视图。你也可以使用一些参数来美化输出：

# 以更简洁的单行格式显示
git log --oneline
# 显示分支的图形化表示
git log --graph --oneline --decorate --all

5. 切换分支 (Switch/Checkout) - 在不同开发线间移动

项目通常会有多个分支，例如主分支 master/main 和各种开发分支。切换分支可以让你在不同的开发任务间工作。

使用 TortoiseGit 切换分支

1. 在项目文件夹的空白处点击右键（或直接在文件夹图标上右键）。
2. 选择 TortoiseGit -> 切换/检出 (S)... (Switch/Checkout…)。
3. 在弹出的对话框中，点击 分支 (Branch) 右侧的下拉箭头或 ... 按钮，选择您想要切换到的目标分支。
4. 点击'确定'，TortoiseGit 会将您的工作目录切换到所选分支的状态。

使用命令行切换分支

1. 进入项目目录：确保您的终端位于项目文件夹内。

执行命令：使用 git switch (推荐) 或 git checkout 命令，后跟要切换的分支名。

# 切换到名为 'develop' 的分支
git switch develop
# 或者使用旧的 checkout 命令
git checkout develop

6. 提交 (Commit) - 保存您的本地修改

当您在本地修改了代码并希望保存这些变更时，需要执行'提交'操作。

使用 TortoiseGit 提交

1. 在项目文件夹的空白处点击右键（或直接在文件夹图标上右键），选择 Git 提交 (C) -> "您的当前分支名"... (Git Commit -> 'branch-name'…)。
2. TortoiseGit 会打开提交对话框，并列出所有被修改、新增或删除的文件。
3. 填写提交信息: 在上方的 '日志信息' (Message) 文本框中，清晰、简明地描述您这次提交的目的和内容。这是一个非常重要的好习惯。
4. 选择要提交的文件: 在下方的 '文件列表' 中，勾选您希望包含在这次提交中的所有文件。
5. 点击'提交' (Commit) 按钮。这会将您的修改保存在本地仓库中，但还未推送到远程仓库。

使用命令行提交

命令行中的提交通常分两步：暂存 (Stage) 和 提交 (Commit)。

1. 进入项目目录：确保您的终端位于项目文件夹内。

执行提交：使用 git commit 命令，并使用 -m 参数直接附上提交信息。

git commit -m "修复了用户登录的 Bug"

这会将暂存区的所有内容创建一次新的提交，并保存在本地仓库中。

暂存文件：使用 git add 命令将您想要提交的文件添加到暂存区。

# 暂存单个文件
git add file.txt
# 暂存所有已修改和新增的文件
git add .

7. 推送 (Push) - 将本地提交分享到远程仓库

提交只是保存在本地。为了让团队其他成员看到您的代码，或者为了备份，您需要将本地的提交'推送'到远程仓库。

使用 TortoiseGit 推送

1. 在项目文件夹的空白处点击右键（或直接在文件夹图标上右键）。
2. 选择 TortoiseGit -> 推送 (P)... (Push…)。
3. 在推送对话框中，通常保持默认设置即可（它会自动选择要推送到哪个远程分支）。
4. 点击'确定'按钮。TortoiseGit 会将您本地所有尚未推送的提交上传到远程服务器。

使用命令行推送

1. 进入项目目录：确保您的终端位于项目文件夹内。

执行命令：运行 git push 命令。

git push

Git 会将您本地当前分支上所有尚未推送的提交上传到与之关联的远程分支。