2. 本地仓库的基本配置先把“家”安好2.1 Git 安装与环境检查如果你还没装过 Git先去官网下载对应系统的安装包。Windows 用户建议直接用 Git Bash它自带一个类 Linux 的命令行环境后面敲命令会舒服很多。装完之后打开终端先确认版本git --version能看到类似git version 2.40.0.windows.1的输出就说明装好了。顺便把全局身份信息配上这一步很多人会跳过但提交记录里的作者信息就是靠它git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的邮箱最好和注册 GitHub 的邮箱保持一致不然提交记录虽然能推上去但账号头像和提交记录对不上后面看着会很别扭。2.2 初始化本地仓库进入你的项目根目录执行git init这条命令会创建一个隐藏的.git文件夹所有版本记录都存在里面。注意这个文件夹不要手动去改也不建议把整个项目目录直接拷贝给别人因为里面可能包含你的历史提交信息。执行完git init之后你的项目还只是一个“被 Git 管理”的目录但里面的文件还没有被跟踪。用git status看一眼通常会发现一堆红色文件意思是“未跟踪”。这时候需要把文件加入暂存区。2.3 首次提交把状态固定下来git add . git commit -m 第一次提交git add .表示把当前目录下所有文件加入暂存区。如果你有一些不想提交的文件比如本地的配置文件、密钥、编译产物需要在项目根目录创建.gitignore文件把路径写进去。这里有个常见的坑git add .会把所有东西都加进去包括一些不该提交的大文件和密钥文件。我建议第一次提交之前先看一眼git status确认没有敏感文件混进来再执行 commit。如果后面想提交单个文件也可以写具体路径git add src/main.py提交完之后本地仓库就已经有一个完整的版本记录了。这时候 GitHub 那边还没动静下一步就是把本地仓库和远程仓库关联起来。 ## 1. 先搞清楚本地项目传到 GitHub 到底在做什么很多人第一次接触 Git 和 GitHub会被那堆命令搞晕。其实核心逻辑非常简单你本地有一个项目文件夹GitHub 上有一个空的远程仓库你要做的是把本地文件夹里的内容同步到远程仓库之后每次改完代码再通过几条命令把增量更新推上去。这个过程本质上就三步在 GitHub 网页上新建一个远程仓库在本地把项目目录初始化为仓库并提交一次“快照”然后把本地仓库和远程仓库关联起来推送上去。听起来简单但实际操作里你会碰到 SSH 密钥、分支名不统一、推送被拒、网络连接失败等一堆问题。这篇文章会把从零开始到日常更新维护的完整流程走一遍顺便把我踩过的坑和排查经验都写出来适合刚接触 Git 的开发者也适合已经会用git add和git commit但还没搞懂推送逻辑的人。先说一个容易混淆的点Git 和 GitHub 不是一回事。Git 是一个分布式版本控制工具跑在你本地GitHub 是基于 Git 的代码托管平台相当于给你提供了一个云端仓库。你本地每次提交commit都是在自己电脑上生成一个版本快照只有执行git push的时候才把本地的新提交同步到 GitHub 上。理解了这一点后面所有命令都是围绕“本地提交”和“远程同步”两个动作展开的。