github菜鸟教程

注册完GitHub账号，菜鸟你盯着那个黑底白字的教程页面，大概率会愣几分钟。菜鸟别慌，教程我第一次也这样。菜鸟仓库、教程分支、菜鸟提交、教程拉取请求——这些词听着像黑话，菜鸟其实干的教程事跟你在家整理文件夹没本质区别。只不过GitHub把每次修改都记了账，菜鸟还能让一群人同时改同一份文件而不打架。教程

先搞清楚一个最核心的菜鸟概念：仓库（Repository）。它就是教程一个项目文件夹，只不过这个文件夹自带历史记录。菜鸟你新建一个仓库，相当于在GitHub的服务器上划了块地。公开仓库所有人可见，私有仓库只有你和被邀请的人能看。免费账号现在也能建无限私有仓库，这点比早年良心多了。

建完仓库，页面上会显示一段命令行指引。别跳过它。那段代码是让你把本地电脑和远程仓库连起来的。最省事的办法是装个GitHub Desktop，图形界面，点点鼠标就能完成克隆、提交、推送。但如果你想真正搞懂，还是得碰命令行。git clone把远程仓库拉到本地，git add告诉Git你要提交哪些改动，git commit -m "说明"把改动打包并附上一句话，git push推回GitHub。这四步走通了，日常协作就够用了。

分支（Branch）是GitHub最值钱的设计。默认分支叫main或master，你可以把它理解成“正式版”。想加个新功能，别直接在main上改。新建一个分支，比如feature-login，在上面折腾。改坏了不影响main，改好了发起一个Pull Request（PR），请求把你的分支合并回main。别人可以在PR里逐行看你的改动，留评论，提意见。这套流程让开源项目能同时接受几百人的贡献而不乱套。

说到开源，GitHub的社交属性全藏在Star和Fork里。Star相当于点赞加收藏，Fork是把别人的仓库复制一份到你账号下。你Fork之后可以随便改，改完还能发起PR请求原作者采纳你的改动。很多新手的第一份贡献就是给文档改错别字——别小看这个，维护者真的会看，而且大概率会合并。我见过有人因为给一个热门项目修了个拼写错误，后来成了该项目的长期贡献者。

Issue是另一个你迟早要碰的东西。它不只是报bug的地方，更像项目讨论区。提问前先搜一下有没有人问过同样的问题。提问时把环境、复现步骤、报错信息贴清楚。没人有义务帮你，但描述得越具体，回复来得越快。那种只写“用不了，求解决”的Issue，通常会被晾着。

有个坑得提前说：GitHub上的代码不等于可以随便用。每个仓库都有许可证（License），MIT、Apache、GPL各有各的规矩。没有许可证的仓库，默认保留所有权利，你复制代码到自己的项目里可能侵权。用之前花两分钟看一眼LICENSE文件，能省掉很多麻烦。

最后说个实用技巧。GitHub的搜索功能比你想的强。在搜索框里加language:python限定语言，加stars:>1000限定热度，加topic:machine-learning限定主题。组合起来能快速找到高质量项目。另外，按t键可以快速调出文件搜索，按s聚焦搜索框，按?看全部快捷键。这些没人会主动教你，但用熟了效率翻倍。

别把GitHub想得太玄。它就是个带版本控制的代码托管平台，外加一层社交网络。你不需要一次学会所有功能，先建个仓库，写个README，提交一次，就算入门了。剩下的边用边查，遇到问题搜Issue，比看教程快得多。