六三门1. 先弄明白GitHub和Git这对“双胞胎”
很多初学者第一次接触GitHub，第一反应是：这跟Git有什么区别？是不是同一个东西？我当年也是先背了一周的命令行，然后发现自己根本不知道每天在敲什么，纯粹是感动自己。等你真正搞懂Git和GitHub的关系，后面的学习会顺很多。
简单说，Git是一个版本控制工具，跑在你本地电脑上的，负责记录代码的每一次修改、回滚、分支合并。GitHub则是一个基于Git的代码托管平台，让开发者可以把本地仓库推到云端，跟别人协作、开源、下载项目。你说“GitHub怎么用”，其实包含两件事：一是学会基本的Git命令，二是弄懂GitHub网站上的仓库、分支、Pull Request这些概念。这两者缺一不可，但也不像传说的那么难。
这篇文章就是写给纯小白的。我会从安装Git开始，把最常用的几个命令、第一次推送项目的完整流程、在GitHub上找项目和参与项目的正确姿势，以及我自己踩过的一些坑全部拆开讲。你不需要任何基础，只要跟着操作一遍，今天就能拥有自己的第一个远程仓库。
顺便说一个热词问题：很多人搜“github初学者怎么学习使用github”，其实卡住的点根本不是代码，而是那一堆英文术语和命令行。所以我的建议是：先动手提交一次，再回头理解原理，这比先把每个概念都背完有效十倍。
1.1 你是来存代码的，不是来背命令的
Git命令很多，光看官方文档能吓退一半人。但对初学者来说，日常高频使用的命令翻来覆去就那么几条：clone、add、commit、push、pull、status、log。这几条能覆盖你80%以上的操作场景。
Git在你本地会维护一个隐藏的.git目录，里面保存着这个项目的所有历史版本。你每次修改代码后，要先通知Git“我改了哪些文件”，用git add把改动放进暂存区；再用git commit把暂存区的改动打包成一个版本记录；最后用git push推到GitHub远程仓库。
我见过很多资料把这种流程画得很复杂，动不动就提工作区、暂存区、版本库三者的概念。这里先说个朴素类比：你写代码就像做饭，git add是把你做好的菜装盘，git commit是给这桌菜拍照留底，git push是把照片发到朋友圈。如果你已经会装盘、拍照、发圈，那Git的核心使用逻辑就掌握了。后面的分支、合并、回滚，都是在完善这个基础模型，不会颠覆它。
1.2 GitHub上最常打交道的几个概念
打开一个GitHub仓库页面，你第一眼看到的是文件列表、README、Star、Fork、Issue、Pull Request等按钮。这几个东西就是GitHub的“门面”，理解它们，你逛任何开源项目都不会迷路。
- Star：相当于点赞收藏，用来标记你感兴趣的项目。
- Fork：把别人的项目完整复制一份到你的账号下，之后你想怎么改都行，不会影响原仓库。
- Watch：订阅仓库的动态，比如Release发布、Issue更新，系统会给你发通知。
- Issue：项目的“留言板+工单系统”，用来提bug、提需求、讨论问题。
- Pull Request（简称PR）：你修改了某个项目后，向原作者发起“请把我的修改合并进原仓库”的请求。
- Release：项目正式发布版本的归档，通常带有版本号，比如v1.0.0。
很多人会把Fork和Star搞混。我刚开始也觉得Fork比Star“高级”，所以见一个Fork一个，结果账号下全是复制的仓库，乱得不行。实际使用中，绝大多数项目你只需要Star就够了，Fork是你要参与代码贡献，或者需要基于这个项目二次开发时才需要做的事情。
1.3 gaoshu705/qzonearchive 这种项目应该怎么读
经常有初学者在GitHub热榜上看到类似 gaoshu705/qzonearchive 这样的名字，完全不知道它是什么意思。这里顺便讲一下仓库名的组成规则：用户名/仓库名。gaoshu705是所有者账号，qzonearchive是这个仓库的名字，通常是项目功能的简写。比如qzonearchive就是“QQ空间存档”的意思，这类工具可以帮助用户备份、导出自己的QQ空间内容。
这种以用户名/仓库名形式出现的项目，你在GitHub搜索栏直接输入完整名字就能定位到。有些项目因为被很多人Star、Fork，会出现在GitHub官方的热门推荐里，网友们也会在社交平台分享。对初学者来说，这是一个很好的学习入口：别光看标题，点进去看README，里面一般写了这个项目解决什么问题、怎么安装、怎么使用、有哪些注意事项。
另外，看到这类项目后，我建议你不要只是收藏，而是亲手把代码clone到本地跑一遍。哪怕你完全看不懂代码，光是“把一个网上的项目拉到本地并成功运行”这件事，就能帮你熟悉GitHub的使用流程，顺便还能练一下Git命令。我第一次clone一个几十万Star的框架时，觉得无非是下载个压缩包，但真正用git clone后才发现，整个过程会连带着把项目的版本历史也拉下来，虽然体积大了点，但你能在本地随时查看这个项目每一步是怎么演进的，这种感觉是下载zip完全给不了的。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 新手必看：Windows/Mac上安装Git并完成身份配置
工具链这件事，最怕的就是“装一半”。我遇到的新手问题里，有一大半卡在Git没装好、环境变量没配好、用户名邮箱没设置就急着push，结果报一堆看不懂的错。所以这一节我直接把完整流程写给你，照着做就完了。
2.1 Git安装到底在装什么
Git的安装包除了命令行工具外，还会带上Git Bash、Git GUI、以及一个“模拟Linux终端”的环境。对Windows用户来说，Git Bash尤其重要，因为很多指令在Windows自带的CMD或PowerShell里写法不太一样，而在Git Bash里几乎跟Linux终端保持一致。初学阶段我建议你统一在Git Bash里练命令，省心很多。
Mac用户更简单，系统自带或通过Homebrew安装都行。不管是哪个平台，装完先验证一下版本：
bash复制git --version
只要能看到类似git version 2.40.0的输出，说明安装成功。
2.2 Windows下安装Git的完整步骤
前往Git官网下载Windows安装包，一路Next到安装选项页时有几个地方需要留意。默认选项通常已经满足大部分需求，但我会手动改一处，把“Adjusting your PATH environment”选成**“Git from the command line and also from 3rd-party software”**，这样以后在CMD或PowerShell里也能直接用git命令。
还有一个藏在“Choosing the default editor”的选项，默认是Vim。如果你没用过Vim，建议换成Notepad++或VS Code，否则以后commit时不小心弹出Vim，你不知道怎么退出，心态直接崩了。
安装完成后，需要重启一下你的终端工具，再去敲git --version。如果你在CMD里输入git提示“无法将‘git’项识别为cmdlet、函数、脚本文件或可运行程序的名称”，十有八九是PATH没配好。解决办法是去“系统属性-环境变量-系统变量-Path”，手动添加Git安装目录下的cmd路径，比如C:\Program Files\Git\cmd，然后重新打开终端。
2.3 配置用户名和邮箱，这一步别偷懒
第一次用Git时，系统并不知道“你是谁”。你要push代码到GitHub，提交记录里必须有一个作者信息。这个信息是你自己配置的，跟注册GitHub账号时的用户名、邮箱最好保持一致，否则你的提交记录不会关联到账号头像上。
在终端里执行：
bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
--global的意思是这台机器上的所有仓库都默认用这个身份。如果你想对某个仓库单独设置，可以去掉--global，在该仓库目录下重新配置。
配置完之后，再执行：
bash复制git config --list
能看到你的name和email就说明配置成功。我见过有人跳过了这一步，然后push时遇到一堆权限校验错误，实际从头到尾都跟身份没配好有关。
2.4 解决“git不是内部或外部命令”和登录失败
“git不是内部或外部命令”这个问题，多数发生在只装了GitHub Desktop，或者安装时把Git的PATH选项选成了“Use Git Bash only”的Windows用户身上。这类报错的核心就是系统找不到git可执行文件，按上面2.2节的方式重新配置PATH即可。
另一个高频报错是 login failed. check api token or gitlab version，看到“gitlab”别慌，很多时候是你在某个IDE插件里填错了GitLab地址或Token，并不一定跟GitHub有关。排查思路分两步：先确认你是在哪个工具里推送的，如果是在VS Code或某些Git GUI插件里，去设置里检查remote地址是否有误；如果是在命令行里推送，大概率是HTTPS凭证过期，重新登录一下即可。
遇到登录问题还有一个最稳妥的方案：配置SSH免密。这个我在3.4节详细讲。用SSH方式远程访问GitHub，能绕开HTTPS每次都要输用户名密码的麻烦，稳定性也好很多。
3. 高频Git命令，先记5条就够用了
Git命令不需要一开始全学，先把最小闭环跑通：git clone把远程仓库拉到本地，git status看当前改动，git add把改动加入暂存，git commit生成提交记录，git push推送到远程。再加上一个git pull拉取别人最新的改动，就够了。
3.1 clone、add、commit、push、pull 的日常循环
先看clone。它的作用是把GitHub上的仓库完整复制到本地，包括所有历史版本。用法是：
bash复制git clone https://github.com/用户名/仓库名.git
执行完成后，当前目录下会多出一个以仓库名命名的文件夹，里面就是一个完整的Git仓库。我建议初学者把要练习的项目都clone到一个专门目录里，避免到处乱放。
再看日常改代码后的三条连招。假设你刚修改了index.html，先：
bash复制git status
这条命令会告诉你哪些文件被修改过、哪些还没被跟踪。确认无误后执行：
bash复制git add index.html
git commit -m "更新首页标题"
git push
add可以接具体文件，也可以接.表示把当前目录下所有改动都加入暂存。新手容易犯的错是git add .后，把不该提交的临时文件也加进去了，所以我建议在项目里养成写.gitignore的习惯，把node_modules、__pycache__、.idea这些目录排除掉。.gitignore的语法很简单，每行写一个要忽略的文件名或目录名，Git看到后会自动跳过它们。
3.2 用实际场景演示第一次推送本地仓库
如果你手上有一个本地项目，还没有推送到GitHub，流程是这样的：先在GitHub上点击“New repository”创建一个空仓库，不要勾选“Add a README file”，否则仓库里会有初始文件，跟你本地项目合并时容易产生冲突。
创建完成后，GitHub会给你三组命令行提示。我以最常见的HTTPS方式为例：
bash复制git init
git add .
git commit -m "第一次提交"
git remote add origin https://github.com/用户名/仓库名.git
git branch -M main
git push -u origin main
这五行命令逐条解释：git init把当前目录初始化为Git仓库；git add .把目录下所有文件加入暂存；git commit生成第一个提交记录；git remote add origin ...给远程仓库起了一个叫origin的别名；git branch -M main把你的默认分支名改成main；git push -u origin main把本地main分支推送到远程，并建立本地分支跟远程分支的关联。
很多老教程会让你用master而不是main，因为GitHub在2020年之后把默认分支名改成了main。如果你用的是新版本Git，git init后本地分支默认叫main，那git branch -M main这行写不写都行。但我建议保留，因为这样明确指定，不会因为版本差异导致推送时分支名对不上。
3.3 处理“fatal: remote origin already exists”等小问题
新手在给本地仓库添加远程地址时，很容易碰到这样一个报错：
text复制fatal: remote origin already exists.
原因很简单：这个仓库之前已经设置过远程地址了。你可以用下面命令查看当前关联的远程地址：
bash复制git remote -v
如果发现原来的地址不是你想要的，直接修改：
bash复制git remote set-url origin https://github.com/用户名/仓库名.git
要是想彻底删掉重新加，也行：
bash复制git remote remove origin
git remote add origin https://github.com/用户名/仓库名.git
这类报错本身不难，难的是初学者不知道“原来还能查”。所以遇到Git报错，第一反应不是去搜索引擎复制整个报错，而是先跑一句git status和git remote -v，看看Git自己知道些什么。实践中有一半的问题，这样自己就能排查出来。
3.4 免密推送：配置SSH Key的完整流程
每次都输用户名密码真心麻烦，尤其是有多个项目要推的时候，体验很糟糕。用SSH Key免密其实不复杂，核心是一次生成密钥、把公钥放到GitHub、之后push就不再问你密码了。
第一步，在终端生成密钥：
bash复制ssh-keygen -t ed25519 -C "你的邮箱@example.com"
一路回车即可，生成的默认位置是~/.ssh/id_ed25519。第二步，查看公钥内容：
bash复制cat ~/.ssh/id_ed25519.pub
复制输出的整行内容，打开GitHub的“Settings -> SSH and GPG keys”，点击“New SSH key”，标题随便写，把公钥粘贴进去保存。
第三步，把远程地址改成SSH格式。在仓库目录下执行：
bash复制git remote set-url origin git@github.com:用户名/仓库名.git
之后再用git push，就不会要求输入账号密码了。需要提醒的是，SSH Key的私钥文件id_ed25519千万不能泄露，也不要把它提交到Git仓库里，否则任何拿到你私钥的人都能以你的身份操作GitHub。之前GitHub有个机器人扫描公开仓库，专门搜这种泄露的密钥，一旦发现会自动给你的邮箱发警告邮件，所以别犯这种低级错误。
4. 在GitHub上找项目、看项目、参与项目
学会push自己的代码后，下一步自然就是去看别人怎么写的。GitHub是全球最大的开源社区，你想要的工具、教程、练手项目，基本都能找到。但前提是你得会“逛”，知道从哪里逛起。
4.1 用关键字和语言筛选项目
GitHub的搜索框比你以为的更强。直接在搜索框输入关键字，然后在左侧筛选栏选择编程语言、Star数区间、最近更新时间，就能排除掉一堆不再维护的垃圾项目。
比如你想学Python的爬虫项目，可以搜python爬虫，然后把Language选为Python，Sort选为Most stars。这样出来的结果基本是经过社区验证的高质量项目。还有一个小技巧是看项目的维护活跃度：点进仓库看最近一次提交时间，如果是一年前更新的，除非是稳定成熟的项目，否则尽量谨慎依赖，因为出了bug可能没人修了。
我也推荐新手关注GitHub的“Explore”和“Trending”页面。Trending页展示最近一段时间内涨Star最快的项目，是发现新工具、新教程的好地方。很多热词里提到的项目，比如gaoshu705/qzonearchive，之所以被人分享出来，就是因为它上了Trending后大家才看到的。所以别只在搜索引擎里找，GitHub自己的推荐机制也很值得逛。
4.2 学会看README、Issues和Release
一个项目值不值得用，不要只看Star数，一定要看README。README通常告诉你这个项目是干嘛的、怎么安装、怎么使用、有哪些功能、项目结构长什么样。很多人clone下来跑不起来，就是跳过了README里的环境要求，直接硬跑。
Issues板块对应项目的“问题反馈区”。你可以在里面搜索别人提过的错误，比如error、windows、404，看是否有跟你同样的情况。如果找不到解决方案，再自己提一个Issue，把系统版本、操作步骤、报错日志完整贴上去，维护者才好帮你定位。
Release板块则相当于正式版本发布区。频繁改动的项目，你从源码拉下来可能是开发版，不稳定；Release里发布的版本一般来说要稳定一些。下载项目时建议优先看Release里的压缩包，别直接点Download ZIP，除非你知道自己需要的是最新源码。
4.3 想给项目贡献代码，先走通Fork到PR流程
如果你在项目里发现了一个bug，修复后想回馈给原作者，正确的流程是Fork、clone、新建分支、修改、push、发起Pull Request。
具体做法：先在项目页点Fork，把仓库复制到你自己的账号下；然后clone你账号下的这个仓库到本地。接着新建并切换到一个功能分支：
bash复制git checkout -b fix-bug
在这个分支上修改代码，走正常的add、commit流程，最后推送：
bash复制git push origin fix-bug
推送完成后，回到GitHub你的仓库页面，会自动出现一个“Compare & pull request”按钮，点开后填写PR描述，就可以提交给原项目维护者了。
很多初学者第一次走这个流程会特别紧张，怕自己改得不好被骂。其实维护者大多很欢迎PR，哪怕不通过，也会礼貌地指出问题。我刚学会提交PR时特别爱找文档错别字、失效链接这类小问题练手，这种PR风险低、价值又明确，很适合积累信心。
4.4 Star和Watch的差别，别搞混
Star前面说了是收藏，Watch则是订阅通知。如果你希望某个项目发布新版本、有人提了重要Issue时收到邮件，就点Watch。不过我不建议订阅太多，否则你的邮箱会被通知轰炸。一般来说，只有你正在深度参与或使用的项目才值得Watch。
这里顺便聊个新手容易忽略的功能：GitHub的手机App。你在App里同样能看Trending、看Issue、merge PR，出门在外刷一刷，比自己啃文档容易很多。我建议你把它安装上，就当刷社区动态了。
5. 初学者常见访问与操作问题排查
最后这部分我想认真写一下实际操作中高频踩坑的地方。所谓“报错不可怕，可怕的是一报错就慌”，你只要理解报错背后的原因，八成问题都能自己解决。
5.1 “GitHub打不开/图片加载不出来”先别慌
“GitHub打不开”这个问题经常出现在网络环境不稳定的情况下，初学者第一反应往往是想去找“加速”工具，但我建议先从最基础的地方排查。先确认你的网络本身是通的，用浏览器打开普通网站看是否正常；再清理一下本机DNS缓存，Windows在命令行里执行ipconfig /flushdns，Mac执行sudo dscacheutil -flushcache。
如果你用的是默认DNS，可以换成公共DNS，比如114.114.114.114或8.8.8.8，然后重新访问GitHub试试。这类调整通常能解决一部分DNS解析异常的问题。
当你GitHub能打开但图片、头像加载不出来，那不是网站挂了，而是部分静态资源走的域名在部分地区连接不稳定。如果你只是看GitHub页面，影响不大；但如果看着烦躁，可以后续在社区里搜索“无法加载头像”等相关解决办法，原理大多是手动指定资源域名解析到可用IP。这里我不展开推荐，因为每个地区的网络情况差异很大，方案不一定通用。
还有一个小建议：克隆大仓库时，如果总是中途断开，可以只做浅克隆：
bash复制git clone --depth 1 https://github.com/用户名/仓库名.git
这样只拉取最新的一次提交记录，体积小很多，速度会快不少。等你后续需要完整历史了，再git fetch --unshallow补全。
5.2 IDE里集成Git的小设置
很多初学者不是用命令行提交代码，而是直接在PyCharm或VS Code里操作Git。这些IDE自带图形界面，提交、推送、切换分支都靠点击按钮完成，确实降低了不少门槛。
但IDE集成的Git有一个前提条件：IDE必须能找到git可执行文件。在PyCharm里，如果打开版本控制后提示“Git executable not found”，你需要去“Settings -> Version Control -> Git”，把Path to Git executable设置为C:\Program Files\Git\bin\git.exe（Windows）或/usr/bin/git（Mac）。
另一个常见问题是：IDE登录远程仓库时弹出一个账号密码框，输对后依然登录失败。这种大概率是IDE在用自己的内置凭据管理器和GitHub交互，而你设置的可能是SSH方式或Access Token。建议你在IDE里将远程地址统一换成git@github.com:用户名/仓库名.git这种SSH格式，并且先在命令行验证SSH是否正常工作：
bash复制ssh -T git@github.com
如果输出一段包含你用户名的欢迎语，说明SSH没问题，IDE里同样能识别到。
5.3 误删本地代码怎么找回
误删文件几乎是每个新手都会经历的痛。删除分两种情况：如果你只是删了工作区的文件，还没执行git add和git commit，可以用git checkout -- 文件名恢复。如果你已经把文件加入暂存区，但还没提交，可以用git restore --staged 文件名把文件从暂存区移回工作区，再恢复内容。
如果删除之后你自己还执行过git commit，那就更不用担心了，Git本身把每一次提交都记录下来了。你可以用git log查看历史提交，找到删除动作之前的那次提交，然后：
bash复制git reset --hard HEAD~1
意思是把仓库回退到上一个提交。不过这个命令要慎重使用，它会丢弃这个提交之后的所有改动。更安全的做法是git revert HEAD，生成一个新的提交来反向抵消旧提交，历史记录上不会丢东西。
5.4 分支和回滚，两个保护自己的命令
Git的分支用好了非常加分。对初学者来说，最实用的一条建议是：不要总是在main分支上直接改代码。每次想加个功能、修个bug，新建一个分支：
bash复制git checkout -b feature/login
在这个分支上随便折腾，确认没问题后再合并回main。就算改坏了，直接切换回main分支，或者把这个分支删掉重来，完全不影响主体代码。这个过程就像写文章时先复制一份副本出来，在副本上大胆修改，定稿后再把内容粘回去。
git reflog也是一个救命命令。如果你执行了git reset甚至误删了分支，reflog会记录下你在本地Git仓库做过的所有操作。用git reflog找到之前的提交哈希，再用git reset --hard 哈希值就能回来。我建议你记一下这两条命令，用不着最好，真遇到问题的时候，它们能让你避免重写一天代码。
5.5 一份“初学者自查清单”
学到这里，你可以按下面这个清单检查自己是否已经跑通完整的GitHub使用流程。不需要做到完美，只要每条都能说出个大概就行。
- 已安装Git，并能在终端识别
git --version - 已配置
user.name和user.email - 已生成SSH Key，并添加到GitHub账号
- 能成功clone一个公开仓库到本地
- 能在本地修改文件后，用add、commit、push推送到远程
- 能在GitHub上找到自己需要的项目，并看懂README
- 能识别Issue、Release、Star、Fork这些页面的作用
- 遇到报错时，会先看
git status和git remote -v，而不是直接抄网上的答案
这里面任何一条卡住了，都可以回到前面的小节再对着走一遍。GitHub学习不拼记忆，拼的是“动手次数”。我第一次折腾SSH Key时也失败了好几次，后来发现就是公钥复制时多复制了一个换行符，这种错误不实际操作根本想不到。
我在带新人时一直强调一个观点：不要等到“会了”再动手，而是先动手再学会。你第一次提交的代码可能很烂，第一次PR可能被拒绝，但只要你完整跑通了流程，后面的一切都会越来越顺。把第一个仓库当成练习，哪怕它只是放了一些练习笔记，也比收藏一百篇教程强。