github使用教程图文详解

打开 github.com，使用右上角 Sign up 按钮点进去，教程邮箱、图文密码、详解用户名，使用三步注册完事。教程别急着建仓库，图文先把右上角头像里的详解 Settings 摸一遍——尤其是 SSH keys 那一栏，后面往本地推代码全靠它。使用

很多人卡在第一步：本地 Git 和 GitHub 是教程两码事。Git 装在自己电脑上，图文管版本；GitHub 是详解远端仓库，管托管。使用两者用 SSH 或 HTTPS 连起来。教程Windows 用户去 git-scm.com 下安装包，图文一路下一步就行。装完在桌面右键能看到 “Git Bash Here”，说明成了。

验证 SSH 有没有配好，打开 Git Bash 敲：

ssh -T git@github.com 

第一次会问 yes/no，输 yes。看到 “Hi 你的用户名” 就通了。没通的话，多半是密钥没加到 GitHub。生成密钥的命令是 ssh-keygen -t ed25519 -C "你的邮箱"，一路回车。然后 cat ~/.ssh/id_ed25519.pub，把输出的一整串复制，粘贴到 GitHub Settings → SSH and GPG keys → New SSH key。标题随便写，比如 “我的笔记本”。

建仓库和第一次推送

点右上角 “+” → New repository。仓库名建议全小写，用短横线连接，比如 my-first-repo。Description 可填可不填，但 README 建议勾上——不然后面还得手动补。.gitignore 模板按语言选，比如 Python 就选 Python，省得把 __pycache__ 传上去。License 选 MIT 最省事。

建完仓库，页面上会显示一串命令。别全信，按自己的情况改。本地新建一个文件夹，进去后：

git init git add README.md git commit -m "first commit" git branch -M main git remote add origin git@github.com:你的用户名/my-first-repo.git git push -u origin main 

注意 git remote add 那行，如果你已经用 HTTPS 克隆过，得先 git remote remove origin 再重新加 SSH 地址。不然每次 push 都让你输密码，烦得很。

日常改代码的节奏

我自己的习惯：改完几个文件，先 git status 看哪些变了。红色是没暂存的，绿色是暂存好的。git add . 全加，或者 git add 文件名 单独加。然后 git commit -m "描述"。描述别写 “update” 这种废话，写 “修复登录页手机号校验” 这种，以后翻记录能救命。

推之前先拉：git pull origin main。如果本地没冲突，直接 git push。冲突了就得手动改文件，改完再 add、commit、push。别怕冲突，冲突就是 Git 在问你 “这两行代码留哪个”，你选一个删掉另一个就行。

分支和 Pull Request

主分支别乱动。新功能开分支：git checkout -b feature/login。写完推上去：git push origin feature/login。然后去 GitHub 仓库页面，会看到一个黄色横幅 “Compare & pull request”，点它。写清楚改了什么、为什么改，指派给 review 的人。合并后记得删掉本地分支：git branch -d feature/login。

有个坑：如果你 fork 了别人的仓库，改完想贡献回去，得先同步上游。命令是 git remote add upstream 原仓库地址，然后 git fetch upstream，再 git merge upstream/main。不同步的话，PR 里会混进一堆别人的提交，维护者看了想打人。

最后说个真事：我见过有人把 node_modules 整个推上去，仓库直接 2GB。GitHub 免费账户单文件限制 100MB，超了推不上去。所以 .gitignore 不是可选项，是保命符。建仓库时就选好模板，或者手动加一行 node_modules/，能省掉后面一堆麻烦。

(责任编辑：综合)