1.8 亿开发者都在用的平台,普通人怎么入门?GitHub 完全上手指南
GitHub 不是程序员专属工具。1.8 亿开发者、6 亿多仓库,腾讯、阿里、字节的开源项目全在上面。现在 AI 编程工具越来越强,普通人也需要一个 GitHub 账号来托管和分享自己的代码。这篇文章从注册讲到 PR,每个步骤都是实操过的。
开源是什么
代码本质是文字,一段程序就是一个文本文件。不开源,文件只在你电脑里。开源,就是把这个文件放到 GitHub 的公开仓库,任何人都能看、复制、修改。
开源不等于放弃所有权。你可以在代码里放一份许可证,规定别人能做什么。MIT 协议最宽松,几乎没有限制。GPL 最严格,别人用了你的代码,他自己的代码也得开源。什么都不放,法律上默认保留所有权利,但实际没人管得住。
Git 和 GitHub 的区别
两个名字长得像,但不是一回事。
Git 是版本控制工具,装在本地电脑上。它记录每一次代码改动,随时能退回到任意历史版本,不用联网。
GitHub 是网站,把 Git 仓库托管到云端,让你能和别人共享代码、协作开发。把本地 Git 仓库推到 GitHub,别人就能看到和下载。
一句话:Git 是本地的版本记录本,GitHub 是这本记录本的云端备份和共享平台。
注册账号
打开浏览器,访问 github.com,点页面中间的绿色 Sign up 按钮。
要填四项:邮箱、密码、用户名、国家。
邮箱用 Gmail。QQ 邮箱和 163 邮箱经常把验证邮件扔进垃圾箱,不推荐。后续用到的 Supabase、Vercel、Cloudflare,全部支持 Google 账号一键登录,一个 Gmail 在 Chrome 里基本能包圆。
用户名会出现在所有代码链接里,别起 test001 这种临时名字,用真实姓名拼音或长期用的英文 ID。
密码让浏览器自动生成强密码,存进密码管理器。自己想的密码大概率跟别处重复,一处泄露全网遭殃。
填完解谜验证,GitHub 发一封验证邮件,里面有 8 位数字验证码,复制粘贴回来,注册完成。
开双重认证(2FA)
注册完第一件事,开 2FA。
GitHub 从 2023 年起强制要求所有有过代码贡献的账号开 2FA。上传过文件、提过 Issue、发过 PR,90 天内必须开,否则账号被限制。
路径:右上角头像 → Settings → Password and authentication → Two-factor authentication → Enable。
三种方式里选 Authenticator app。手机下载 Google Authenticator,扫码绑定,之后每次登录除了密码还要输入 App 里的 6 位动态码。
绑定完成后 GitHub 给你 16 个恢复码。手机丢了、App 删了,这 16 个码是唯一的找回方式。复制进密码管理器,或打印出来放抽屉里。
创建仓库
右上角点加号图标,选 New repository,填几项:
仓库名,全小写英文,单词之间用连字符,比如 my-first-project,别用中文。
Description 写一句话说清楚这个仓库干什么。可以不填,但建议填,以后自己回来看一眼就懂。
Public 还是 Private,公开仓库任何人都能看,私有仓库只有你和邀请的人能看。免费账号两种都能无限建。
初始化选项里,Add a README file 勾上。没有 README 的仓库,别人点进来扫一眼就走。Add .gitignore 选 None,后面再说。Choose a license 不打算开源给别人用可以不选。
点绿色的 Create repository,仓库建好了,里面只有一个 README.md,后面推代码进来就会充实。
搜索项目
顶部搜索栏直接打字就能搜。搜索结果页左侧有类型筛选,切到 Repositories 看仓库,切到 Code 看代码内容。
几个常用限定符:
language:python,只搜 Python 项目stars:>1000,只要 Star 数超过一千的项目pushed:>2026-01-01,今年还在更新的活跃项目in:name,关键词出现在仓库名里
组合起来用。想找 Python 写的、Star 过五千、今年还活跃的机器学习项目,搜索框里打:
machine learning language:python stars:>5000 pushed:>2026-01-01比在搜索引擎里搜某某项目推荐快一个数量级,结果也干净,没有 SEO 灌水文章夹在中间。
读懂一个仓库
仓库名格式是「用户名/仓库名」,点用户名能跳到那个人的主页。旁边小标签标注 Public 或 Private。
右上角三个按钮:
Star,收藏加点赞。点了之后仓库进你的收藏夹,头像菜单的 Your stars 里能找到。Star 数越高说明项目越受欢迎,选开源项目先看这个数字。
Fork,把整个仓库复制一份到你自己账号下,复制完是独立副本,随便改不影响原项目。
Watch,订阅更新通知,这个仓库有新 Issue、PR、版本发布,你都会收到通知。不需要通知就别点。
标签页里日常用前三个:Code 是默认页,看代码和文件;Issues 是工单区,提 bug、提需求、问怎么用;Pull requests 是合并请求区,给开源项目贡献代码时才用。Actions、Projects、Wiki、Security、Insights、Settings 这六个,上手第一周用不到,不用管。
Code 标签页里,左上角分支下拉框默认显示 main,就是主分支,只看这个就行。中间文件列表跟电脑上的文件夹一样,点文件名看代码,每个文件名旁边有最后修改时间和说明。文件列表上方绿色 Code 按钮是下载代码的入口。
文件列表下方是 README.md,打开仓库自动渲染在最显眼的位置。README 是作者写的项目说明书,一般包括项目是什么、怎么安装、怎么用、几个示例。看陌生项目先看 README,就知道值不值得细看。
右侧 About 栏显示项目简介、主要编程语言、Star 数、Fork 数。往下拉有 Releases 版本发布区,想下载稳定版本直接来这里找压缩包,不用克隆整个仓库。
如果 README 里没写怎么安装,这个项目大概率没打算给别人用,或者维护者没顾上写文档。换个同类型有 README 的项目更省时间。
Issues 工单系统
Issues 是这个项目的留言板加 bug 报告中心。
任何人都能点 New issue 按钮,写标题和正文,报 bug、提新功能、问怎么用都行。
提 Issue 之前做两件事:先在 Issues 页面搜一下有没有人问过同样的问题,重复的 Issue 维护者直接关掉;再看仓库根目录有没有 CONTRIBUTING.md 或 ISSUE_TEMPLATE,按对方要求的格式填。
本地 Git 操作
不需要装 Git,不需要背命令。打开 AI 编程工具(Cursor、Copilot、Claude Code、Trae 都行),直接说话就行。
把项目变成 Git 仓库时,对 Agent 说:「帮我初始化 Git 仓库」
下载别人的仓库,把仓库地址复制下来,对 Agent 说:「帮我把这个仓库克隆到本地 github.com/xxx/xxx」
改完代码提交,对 Agent 说:「提交所有改动,说明是:修复了登录页白屏」
推到 GitHub,对 Agent 说:「推送到 GitHub」
拉取远端更新,对 Agent 说:「拉一下最新代码」
本地代码关联空仓库,对 Agent 说:「帮我把这个项目关联到 GitHub 上的 xxx 仓库,然后推送上去」
就这六句话。Agent 在后台自动执行,包括第一次推送时自动配好 SSH Key。
部署上线
代码推到 GitHub 之后,让别人能在浏览器里看到。
静态 HTML 页面走 GitHub Pages,对 Agent 说:「帮我把这个仓库部署到 GitHub Pages」。Agent 给你一个 你的用户名.github.io/仓库名 的公开地址,任何人打开就能看。
React、Vue、Next.js 这类前端框架项目走 Vercel,对 Agent 说:「帮我把这个项目部署到 Vercel」。Agent 自动关联 GitHub 仓库、自动 build、自动分配 vercel.app 域名。之后每次 git push,Vercel 自动重新部署。免费套餐个人项目够用。
自己的博客用 GitHub Pages 托管,一年没花过一分钱,加载速度比国内很多付费虚拟主机还快。
适合放的:个人作品集、博客、开源项目文档站。不适合的:需要后端数据库的应用、需要登录注册的系统。
Fork 复制仓库
进任何一个公开仓库,右上角点 Fork。GitHub 把整个仓库完整复制一份到你的账号下,你拥有这个副本的完全控制权。
Fork 出来的仓库随便改,不影响原项目。原作者更新了新代码,你这边不会自动同步,想同步点一下 Sync fork。
什么时候 Fork:想给别人的项目贡献代码,先 Fork 到自己账号下,在副本里改,改完发起 Pull Request 申请合并回原项目;或者想基于别人的代码改一个自己的版本。
Pull Request
PR 是开源协作的核心流程。
先 Fork 目标项目到自己账号下,用 git clone 把 Fork 仓库拉到本地,在本地改代码,add、commit、push 推上去。
打开自己 Fork 仓库的 GitHub 页面,顶部会出现黄色提示条,问要不要发起 Compare and pull request。点了之后填写标题和描述,说清楚改了什么、为什么这么改,点 Create pull request。
原项目维护者收到通知,看你的代码改动,可能留言让你改几处,也可能直接点 Merge 合并。合并之后,你的代码正式进入原项目。
几个值得看的开源仓库
通义千问 Qwen,阿里开源的大语言模型系列,从 7B 到 72B 参数全量开放,模型权重和训练代码全部可下载。地址:github.com/QwenLM/Qwen
飞书开放平台 CLI 工具,官方开源,覆盖消息、日历、文档、邮箱、会议等 11 个业务域,带 19 项 AI Agent Skills,发布不到两个月 Star 破万。地址:github.com/larksuite/cli
Apollo 11 登月源代码,1969 年阿波罗 11 号制导计算机的原始代码,14.5 万行,3 万多 Star。代码注释里能看到五十多年前工程师的英文俚语,是真实的历史工程资料。地址:github.com/chrislgarry/Apollo-11
HowToCook,程序员做饭指南,80K Star。每道菜标难度等级、材料精确到克、步骤拆成条件分支。不含一行代码,是 GitHub 上最实用的非代码仓库之一。地址:github.com/Anduin2017/HowToCook
English-level-up-tips,46K Star,7 层结构从基础认知到 AI 工具,每层独立,挑着看都行。地址:github.com/byoungd/English-level-up-tips
看这些项目不需要看懂所有代码。打开先看 README,再看文件结构,点几个核心文件感受一下真实项目长什么样,比翻教程快得多。
到这里,注册、搜索、建仓库、读仓库、本地 Git、部署、Fork、PR,全套流程都覆盖了。剩下的就一件事:打开 GitHub,搜一个感兴趣的项目,clone 到本地,改点东西,push 上去。踩过一次完整流程,这些才是你自己的。