ARTICLE · 1092160
GitHub从入门到精通:搜索技巧、源码五步法、七个最贵的坑
GitHub 是全世界程序员放代码的地方，也是你白嫖别人代码的地方。原文是 X 上 12 万阅读的万字教程，这篇把最值钱的部分压成一篇：搜索技巧、读懂源码五步法、七个代价最高的坑、免费额度清单，10 分钟读完，能建仓库、能提 PR、能看懂陌生项目。
一、先分清 Git 和 GitHub
很多新手第一次提交代码卡住，是因为把这俩当同一个词：Git 是装在你电脑上的版本管理工具，GitHub 是托管 Git 仓库的网站。类比：Git 是你抽屉里的记账本，GitHub 是帮你保管和共享的银行。没有 GitHub，Git 照样能用；没有 Git，GitHub 就是个空壳。
新手期别在 GitHub 网页上点来点去「提交」文件——本地用 git 命令，网页 99% 用来浏览和 star。
▲ Git 记本地历史，GitHub 管云端协作
为什么必学：带历史的备份（误删文件夹三天工作没了的亏，Git 防的就是这个）；GitHub 就是简历（招聘的人会点进主页看提交记录，空白账号比没有账号还尴尬）；全世界最好的代码都摊开放在这，免费看。
二、四个概念就够：仓库、提交、分支、远程
仓库 Repository就是一个被 Git 管理的项目文件夹；提交 Commit是给项目拍快照，附一句说明；分支 Branch是从主线分出来的平行副本，改完再合回去；远程 Remote是 GitHub 上的仓库副本，本地和它同步：add → commit → push 三连。
认证用 PAT（个人访问令牌）或 SSH Key：图省事选 PAT（当密码用），一次配置长期省心选 SSH。
三、搜索技巧：大部分人只会打一个词
GitHub 搜索有语法，会几个限定符就够了：`in:name` 搜仓库名、`language:go` 限语言、`stars:>1000` 过滤明星项目、`topic:self-hosted` 按标签逛。
最有价值的是 `pushed:>2026-01-01`——只看最近还在更新的。GitHub 搜索结果大部分是坟，这个能帮你绕过去。组合示例：找一个还在维护的 Go 自建聊天室：
chat language:go stars:>500 pushed:>2026-01-01
切到 Code 标签页能搜代码本身（需登录）：想看别人怎么用 cloudflared 做隧道，搜 `cloudflared language:yaml`，每条都是真实项目的实际配置，比看文档快。想学什么先搜 awesome 关键词——awesome-python 这类仓库是有人替你整理好的清单。
▲ 组合限定符搜索：40 个精准结果
四、读懂一个陌生项目：五步法
不要从第一行开始读——那是新手最容易死的方式，几万行代码读到天亮也读不出东西。固定走五步：
1. 只读 README（5分钟）：解决什么问题、怎么跑起来、有没有 Quick Start。README 写得烂的直接放弃——不是偏见，是止损
2. 跑起来：静态读代码的效率比跑起来调试低十倍。装依赖、起服务、随便点几下，建立手感
3. 找入口：Go 找 main.go 的 func main()，Python 找 app.py，Node 看 package.json 的 scripts
4. 顺着一个功能走完整条线：从入口开始，挑一个你关心的功能（比如登录），从请求进来到返回，完整走一遍调用链
5. 只读你需要的部分：带着问题读，别贪全。AI 时代这步可以交给 Claude/GPT 辅助，但架构要自己看
▲ 先找入口，再走通一条线
git clone https://github.com/用户名/项目名.git # 或者网页上 Code → Download ZIP
▲ Clone 三种方式：HTTPS / SSH / 直接下 ZIP
五、七个代价最高的坑
坑1：把 .env 提交上去了。密钥、数据库密码全等于公开发布，而且删掉文件再提交没用——历史里还在。光删不够得清历史（git filter-repo / BFG），更省事的做法：直接把 key 作废重申请。
# .gitignore 第一行就写这些 .env node_modules/ .DS_Store *.log
坑2：单文件超 100MB 推不上去，报错只给一串 hash 不说是哪个文件。查大文件：
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sort -k3 -n | tail -5
坑3：提交邮箱和账号对不上——git config user.email 查一下，不一致贡献格子不亮。坑4：在 main 上改崩了——reset --hard 之前先 git stash，后悔了还能捞回来。坑5：fork 之后原项目更新了——把原项目加为 upstream 再 merge。坑6：两步验证恢复码没存——那组码只显示一次，换手机账号锁两天（作者亲历），存密码管理器，别截图放相册。
▲ 密钥泄露、超大文件、误删改动是三大重灾区
六、白嫖清单和主页简历
GitHub 免费档给的东西比大部分人以为的多：公开/私有仓库不限量；Actions 公开仓库基本不限、私有 2000 分钟/月；Pages 静态网站送 HTTPS（博客、文档、demo）；Codespaces 120 核心小时/月；Copilot 每月 2000 次补全。
提醒：Codespaces 的坑在存储——停掉只停算力计费，存储照样算钱，不用了要删掉不是停掉。Actions 分钟数不累积。
主页简历知道的人不多但性价比极高：建一个和你用户名同名的仓库，里面的 README 会显示在主页顶部。三条经验：少写「热爱技术」，写你手上正在做的具体的东西；要放链接；半年更新一次——写着「正在做 A」结果 A 早黄了，比不写还尴尬。
▲ 仓库 · Actions · Pages · Codespaces，免费工具箱
速查表：每天真正用的就这几条
git status → git add . → git commit -m "说明" → git push
git pull # 先拉远端再动手，少打架
git stash / git stash pop # 临时存一版，切分支救急
git log --oneline # 快速看历史
▲ 先看 status，再决定下一步
整理自 X @xaiwind（想风）《万字长文｜超详细的 GitHub 教程》，原文 12 万阅读，版权归原作者，本文为精编版，完整 15 章请看原文。
📌 更多硬核教程
关注「AI智管局」，AI 时代的工具箱持续更新
— END —