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/,能省掉后面一堆麻烦。
(责任编辑:探索)














