第 6 章 GitHub 实战 · 建仓、上传、修改一个仓库

easycode · Agent Skill

这一章回答一个最实际的问题，手上有个本地项目，怎么把它变成 GitHub 上的一个仓库？以及之后怎么持续修改它。

第一步，云上建一个空仓。GitHub 网页右上角 New repository，起名（小写加连字符是惯例），选 Public（公开，全世界可读，秘密纪律立刻拉满）还是 Private（私有，受邀才可见）。关键一条，不要勾选自动生成 README 之类的初始化选项，要让云上是个完全的空仓。不然它有一份历史，你本地另有一份历史，第一次推送就会打架。

第二步，三行咒语，把本地推上去。建完空仓，GitHub 会把这三行摆在你面前。

git remote add origin https://github.com/你的用户名/仓库名.git
git branch -M main
git push -u origin main

逐行翻译，咒语立刻祛魅。第一行给云上那个仓库在本地存个"联系人"，名字叫 origin，惯例名，就像手机里存"家"。第二行把当前主分支改名为 main，现行惯例的主干名。第三行把 main 推给 origin，-u 的意思是记住这对关系，从此以后每天只需要裸敲 git push。首次推送会要求登录 GitHub 授权，跟着提示走即可。刷新网页，看到自己的代码出现在云上。记住这一刻的感觉。

之后的修改，就是第 5 章的循环。改，add，commit，push，网页上随之更新。两个补充场景。反方向，云上已有仓库想搬到新电脑，git clone 地址 整仓复制，第一册讲过。网页直改，README 里改个错别字，不必回本地，网页上点铅笔图标改完直接 commit。但注意，网页上改过之后，本地就旧了，回到本地先 git pull 把云上的新箱子拉下来。由此得出一条终生习惯，动手之前先 pull，让本地永远从最新状态出发。

关键领悟

remote add、branch -M、push -u 这三行一辈子只在建仓时用。真正天天用的，还是那四步循环加一个 pull。

试一试

把 playground 推上 GitHub，走完整流程，别让 AI 代劳。然后在网页上用铅笔改一个字，回本地 git pull，观察改动流回来。