跳到主要内容Windows 下 Git 常规操作:命令行与 TortoiseGit | 极客日志Shell / Bash
Windows 下 Git 常规操作:命令行与 TortoiseGit
本文详细介绍了在 Windows 环境下使用 Git 进行版本控制的两种主要方法:命令行工具与 TortoiseGit 图形界面。内容包含用户信息的全局与项目级配置、远程仓库的克隆与更新、提交历史查看、分支切换、本地修改提交以及代码推送等核心操作。通过对比两种方式的执行步骤,帮助开发者快速上手 Git 的基本工作流。
Windows 下 Git 常规操作:命令行与 TortoiseGit
Git 是目前最流行的版本控制系统,而在 Windows 平台,我们可以通过多种方式与它交互。本教程将介绍两种最主流的方法:
- TortoiseGit:俗称'小乌龟',它与 Windows 资源管理器深度集成,提供了便捷的图形化界面(GUI),非常适合初学者。
- 命令行 (Command Line):通过 PowerShell、CMD 或 Git Bash 等终端工具直接使用 Git 命令,这是更通用、更强大的方式,也是专业开发的必备技能。
本教程将引导您同时掌握这两种方式,完成最常见的几个操作:克隆、更新、查看日志、切换分支、提交和推送。
1. 初始配置:设置您的用户信息
在您首次提交代码前,必须为 Git 设置您的用户名和电子邮件地址。每一次提交都会记录这些信息,以便追溯代码是谁贡献的。
Git 的配置有不同的级别,最常用的是 和 两种:
全局(Global)
项目(Local)
- 全局配置:对当前电脑用户的所有 Git 项目生效。通常在新电脑上只需设置一次。
- 项目配置:仅对当前项目生效,会覆盖全局配置。适用于您在特定项目中使用不同身份的场景。
建议:先设置好全局配置,然后在有特殊需求的项目里再单独设置项目配置。
1.1. 全局配置 (Global) - 对所有项目生效
使用 TortoiseGit (全局)
- 在桌面或任意文件夹空白处右键,选择
TortoiseGit -> 设置 (E) (Settings)。
- 在弹出的对话框左侧,选择
Git。
- 在右侧的'用户资料' (User Info) 部分,直接填写您的
名称 (N) (Name) 和 电子邮件 (E) (Email)。
- 点击'确定'或'应用'保存。TortoiseGit 会将这些信息写入您的全局
.gitconfig 文件中。
使用命令行 (全局)
- 打开任意终端 (PowerShell, CMD, Git Bash)。
- 验证配置:运行
git config --global user.name 和 git config --global user.email 可以查看当前设置好的全局用户信息。
执行以下两条命令,即可为当前电脑用户设置全局用户信息。
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
1.2. 项目配置 (Local) - 仅对当前项目生效
如果某个特定项目需要使用不同的用户名或邮箱,您可以进入该项目进行单独配置。
使用 TortoiseGit (为当前项目)
- 在项目文件夹中任意位置右键,选择
TortoiseGit -> 设置 (E) (Settings)。
- 在弹出的对话框左侧,选择
Git。
- 点击
编辑本地 .git/config(L) 按钮。这会用文本编辑器打开当前项目的 Git 配置文件(位于 .git/config)。
在文件中添加或修改 [user] 部分,然后保存并关闭文件。
使用命令行 (为当前项目)
- 打开终端:在您的项目文件夹中,启动 PowerShell 或 Git Bash。
- 验证配置:在该项目目录下运行
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 克隆
- 复制仓库地址:首先,在 Git 托管平台(如 GitHub, GitLab, Gitee)上找到您想要克隆的项目的仓库地址(通常以
.git 结尾),并复制它。
- 打开克隆对话框:在您希望存放项目的文件夹空白处,点击鼠标右键,在弹出的菜单中选择
Git 克隆 (C)... (Git Clone…)。
- 填写信息:
- URL: 粘贴您刚刚复制的仓库地址。
- 目录 (Directory): TortoiseGit 会自动根据仓库名填充一个本地目录名,您也可以修改为您希望的路径。
- 其他选项通常保持默认即可。
- 执行克隆:点击'确定'按钮。TortoiseGit 会开始下载仓库内容,完成后您会在指定位置看到一个新的项目文件夹。
使用命令行克隆
- 打开终端:在您希望存放项目的文件夹中,点击鼠标右键,选择'在终端中打开'或类似的选项,启动 PowerShell 或 Git Bash。
执行命令:输入 git clone 命令,并在后面跟上您复制的仓库地址,然后按回车。
git clone https://github.com/example/project.git
Git 会开始下载仓库,并在当前目录下创建一个与项目同名的文件夹。
3. 更新 (Pull) - 同步远程仓库的最新代码
当远程仓库有新的提交时,您需要通过'拉取'操作来更新本地代码,以保持与团队同步。
使用 TortoiseGit 拉取
- 进入您的项目文件夹。
- 在文件夹空白处点击右键(或直接在文件夹图标上右键),选择
TortoiseGit -> 拉取 (P)... (Pull…)。
- 在弹出的对话框中,通常无需修改任何设置,直接点击'确定'。
- TortoiseGit 会自动抓取(Fetch)远程最新的改动并将其合并(Merge)到您当前的分支。
使用命令行拉取
Git 会自动从远程仓库拉取最新的变更并与您本地的分支合并。
进入项目目录:首先,使用 cd 命令进入您的项目文件夹。
4. 查看日志 (Log) - 浏览项目的提交历史
查看日志是了解项目变更历史、追溯代码修改的重要途径。
使用 TortoiseGit 查看日志
- 在项目文件夹的空白处点击右键(或直接在文件夹图标上右键)。
- 选择
TortoiseGit -> 显示日志 (L) (Show log)。
- 日志窗口会列出所有的提交记录,从最新到最旧。您可以:
- 点击任意一条记录,查看该次提交修改了哪些文件。
- 在下方文件列表中双击某个文件,可以具体查看修改的内容。
- 看到清晰的分支演进图。
使用命令行查看日志
终端会按时间顺序列出所有提交记录,包含提交哈希值、作者、日期和提交信息。按 q 键退出日志视图。你也可以使用一些参数来美化输出:
git log --oneline
git log --graph --oneline --decorate --all
5. 切换分支 (Switch/Checkout) - 在不同开发线间移动
项目通常会有多个分支,例如主分支 master/main 和各种开发分支。切换分支可以让你在不同的开发任务间工作。
使用 TortoiseGit 切换分支
- 在项目文件夹的空白处点击右键(或直接在文件夹图标上右键)。
- 选择
TortoiseGit -> 切换/检出 (S)... (Switch/Checkout…)。
- 在弹出的对话框中,点击
分支 (Branch) 右侧的下拉箭头或 ... 按钮,选择您想要切换到的目标分支。
- 点击'确定',TortoiseGit 会将您的工作目录切换到所选分支的状态。
使用命令行切换分支
执行命令:使用 git switch (推荐) 或 git checkout 命令,后跟要切换的分支名。
git switch develop
git checkout develop
6. 提交 (Commit) - 保存您的本地修改
当您在本地修改了代码并希望保存这些变更时,需要执行'提交'操作。
使用 TortoiseGit 提交
- 在项目文件夹的空白处点击右键(或直接在文件夹图标上右键),选择
Git 提交 (C) -> "您的当前分支名"... (Git Commit -> 'branch-name'…)。
- TortoiseGit 会打开提交对话框,并列出所有被修改、新增或删除的文件。
- 填写提交信息: 在上方的 '日志信息' (Message) 文本框中,清晰、简明地描述您这次提交的目的和内容。这是一个非常重要的好习惯。
- 选择要提交的文件: 在下方的 '文件列表' 中,勾选您希望包含在这次提交中的所有文件。
- 点击'提交' (Commit) 按钮。这会将您的修改保存在本地仓库中,但还未推送到远程仓库。
使用命令行提交
命令行中的提交通常分两步:暂存 (Stage) 和 提交 (Commit)。
执行提交:使用 git commit 命令,并使用 -m 参数直接附上提交信息。
git commit -m "修复了用户登录的 Bug"
这会将暂存区的所有内容创建一次新的提交,并保存在本地仓库中。
暂存文件:使用 git add 命令将您想要提交的文件添加到暂存区。
git add file.txt
git add .
7. 推送 (Push) - 将本地提交分享到远程仓库
提交只是保存在本地。为了让团队其他成员看到您的代码,或者为了备份,您需要将本地的提交'推送'到远程仓库。
使用 TortoiseGit 推送
- 在项目文件夹的空白处点击右键(或直接在文件夹图标上右键)。
- 选择
TortoiseGit -> 推送 (P)... (Push…)。
- 在推送对话框中,通常保持默认设置即可(它会自动选择要推送到哪个远程分支)。
- 点击'确定'按钮。TortoiseGit 会将您本地所有尚未推送的提交上传到远程服务器。
使用命令行推送
Git 会将您本地当前分支上所有尚未推送的提交上传到与之关联的远程分支。
微信扫一扫,关注极客日志
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown 转 HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
- HTML 转 Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
- JSON 压缩
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
- JSON美化和格式化
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online