很多开发者在接触Linux环境时，第一步就是要搞定版本管理工具。Git是目前最主流的代码托管方案，而Ubuntu又是服务器和开发机最常用的操作系统之一。如果你正在寻找一份能直接保存成PDF、方便离线查阅的Git入门手册，这篇内容就是为你准备的。它把安装步骤、基础命令和日常协作流程全部拆解开，语言尽量口语化，没有复杂的理论堆砌，看完就能上手。
一、通过终端完成Git的安装与环境检查
在Ubuntu上装Git非常简单，不需要去官网下载编译包。打开终端快捷键是Ctrl加Alt加T，然后输入sudo apt update刷新软件源列表。接着运行sudo apt install git-all这条命令，系统会自动拉取依赖并完成安装。整个过程通常只需要几分钟。安装完毕后，别急着写代码，先验证一下是否成功。在终端输入git version，如果屏幕返回类似git version 2.34.1的字样，说明环境变量已经配置妥当，可以直接进入下一步。
二、初始化本地仓库与身份设置
新建一个项目文件夹，比如mkdir my_project，然后cd进去。执行git init就会在当前目录生成隐藏的.git文件夹，这就是你的本地仓库了。这时候Git还不知道你是谁，需要补上身份信息。分别运行git config user.name你的名字和git config user.email你的邮箱地址。这两条配置只针对当前项目生效，如果想让所有项目都默认使用同一套身份，可以在命令后面加上global参数。信息填好后，可以用git config list查看是否写入成功。
三、掌握三个核心工作区的流转逻辑
很多人觉得Git复杂，其实只要理清工作区、暂存区和提交区的关系就通了。你在编辑器里改完文件，改动还在工作区，Git暂时看不见。想把这些修改打包，就用git add文件名或者git add .把整个文件夹推送到暂存区。确认没问题后，执行git commit -m提交说明文字，改动才会正式落盘变成历史记录。记住add是准备上车，commit才是发车，漏掉哪一步都会导致记录断裂。
四、分支管理与日常协作技巧
单线开发很容易撞车，学会用分支是进阶的必经之路。git branch可以列出所有分支，git checkout -b新分支名能快速创建并切换过去。修bug或者做新功能时，一定要开独立分支，完成后切回主分支执行git merge新分支名合并代码。遇到冲突不要慌，Git会在报错的文件里标出冲突标记，手动编辑保留需要的部分，再重新add和commit就行。合并前建议先用git log --oneline看看提交历史，保持整洁。
五、如何将本文内容导出为离线PDF文档
为了方便随时查阅或打印，你可以把这份教程存成本地文件。在浏览器打开当前页面，按下Ctrl加P调出打印窗口，将目标打印机改为另存为PDF。勾选背景图形选项能让排版更清晰，点击保存后就能得到一份完整的电子版手册。也可以把终端里的操作记录用脚本重定向到文本文件，配合Markdown转换器生成带代码高亮的专业PDF。这样无论断网还是出差，都能快速定位关键命令。
六、常见问题排查与后续学习方向
如果在操作中碰到权限拒绝或者连接超时，大概率是网络代理没配好或者SSH密钥过期。Ubuntu下可以通过export https_proxy设置临时通道，长期解决建议配置~/.gitconfig的http.proxy字段。关于远程仓库，GitHub和Gitee的操作逻辑一致，绑定公钥后直接用git remote add origin链接地址即可。掌握了基础流转后，可以进一步研究git rebase变基操作、tag打标签发布以及submodule子模块嵌套。多在实际小项目里跑通一次全流程，比死记硬背命令行要有效得多。
