大家好，我是楮墨。
我现在每天有个固定习惯，就是打开电脑第一件事先去 GitHub 上看看又有什么新的项目，哪些会对我的工作有帮助。
但是，最近我发现一个问题，一些发给朋友们的项目，有好多人没去看，我咨询了一下，原来不是他们觉得这个项目无用，而是压根就不知道 github 是啥，该如何操作.......
在说具体操作之前，先解决一个基础问题： GitHub和 Git 到底是什么关系？
Git 是一个版本管理工具，帮你管理代码的历史记录。换句话说，它能记住你每次改了什么，什么时候改的，改错了还能反悔。
GitHub 是一个平台，简单理解就是"网上的代码仓库"。你在本地用Git管理的代码，可以通过GitHub同步到网上，这样别人能看到，也能一起协作。
打个比方：**Git就像是你的本地记账本，GitHub就像是云端备份的账本。**两配合着用，数据安全有保障。
明白了这个，接下来我们开始实操。
第一步：注册GitHub账号
点击右上角的"Sign up"，填写三样东西：
用户名（建议用英文，以后会成为你的专属地址，比如github.com/你的名字）
建议用户名选简单好记的，最好跟你的习惯一致。因为以后找工作，很多HR会去看你的GitHub主页，一个干净整洁的ID能给人家留下好印象。
用户名可以修改（Settings → Account → Change username），但修改后旧链接会失效，建议想清楚再填
GitHub只是一个平台，真正在本地管理代码的是Git。所以你需要在电脑上安装Git。
验证安装是否成功，在窗口里输入： git --version
如果显示类似"git version 2.x.x"的字样，说明安装成功了。 brew install git
第三步：配置 SSH 密钥（重要）
这是让GitHub认识你电脑的关键一步，也是新手最容易踩坑的地方。
打开Git Bash，输入： ssh-keygen -t ed25519 -C "你的邮箱地址"
敲回车，它会问你保存在哪里，直接敲回车用默认路径就行。
然后它会问你要不要设密码，这个可以设，也可以不设。设的话记牢了，以后会用到。
如果系统不支持ed25519 （旧系统或某些特殊环境），用：
ssh-keygen -t rsa -b 4096 -C
接下来，找到刚才生成的密钥文件。在Git Bash里输入： cat ~/.ssh/id_ed25519.pub
Mac用户如果提示权限问题，用： cat /Users/你的用户名/.ssh/id_ed25519.pub
终端会显示一串以" ssh -ed25519"开头的长字符， 全选复制 。
然后回到GitHub网页：
点击右上角的头像 -> Settings
左边菜单找"SSH and GPG keys"
点"New SSH key"
Title随便填，比如"我的电脑"
Key那一栏，把刚才复制的内容粘贴进去
点"Add SSH key" ssh -T git@github.com
如果看到"Hi xxx! You've successfully authenticated, but GitHub does not provide shell access."，恭喜你，配置成功了。
如果提示"Connection refused"，多试几次，或者检查网络
如果提示"Permission denied"，可能是密钥没添加对。重新复制~/.ssh/id_ed25519.pub的内容（如果用的是RSA，则复制id_rsa.pub）
第四步：创建你的第一个仓库
仓库（Repository），简单理解就是一个放项目代码的地方。
在GitHub网页上：
点击右上角的"+" -> "New repository"
Repository name填你的项目名，比如"my-first-project"
Description 是描述，可填可不填
选择Public（公开）或 Private （私有）
勾选"Add a README file"（推荐勾选）
点击"Create repository"
这样你的第一个仓库就创建好了。
第五步：把代码推上去（核心操作）
这是最关键的一步，也是新手最迷糊的地方。我分步骤来讲。
1. 克隆 仓库到本地
在你的仓库页面，点绿色的"Code"按钮，复制那个URL。
然后在Git Bash里，切换到你想要存放代码的目录： cd /f/my-projects
把仓库克隆到本地： git clone
比如你在文件夹里新建了一个index. html 。
首先，把文件添加到暂存区： git add index.html
如果有很多文件要添加，用： git add .
git add . 会添加当前目录下所有变更（Git 2.0+）。如果用的是很老的Git版本，用 git add -A 更保险。
然后提交，并写上备注： git commit -m "添加了首页文件"
执行前先确认 ：用git branch查看本地分支名。如果显示master而不是main，把下面命令里的main换成master，或者先用git branch -m main改名。
这是最后一步： git push origin main
不能用密码。GitHub从2021年起已彻底禁用密码验证。如果看到的是Fine-grained tokens，选Contents的Read and write权限。
刷新GitHub页面，你的代码就出现在仓库里了。
第六步：常见报错合集
这几个错误，我当年都踩过：
报错1：Permission denied
原因：SSH密钥没配好
解决：重新检查第三步的SSH配置，或者用HTTPS方式克隆
报错2：nothing to commit
原因：你没做任何修改
解决：确认文件放对位置了，git add . 之后再看
报错3：! [rejected] main -> main (fetch first)
原因：远程仓库有新代码，你没同步
解决：先git pull --rebase origin main，解决可能的冲突后再git push origin main。（如果不用--rebase，会产生额外的合并提交，让历史记录变乱）
报错4：fatal: not a git repository
原因：没在git仓库目录里，或者.git目录被误删
解决：确认你在正确的文件夹（用ls -la | grep .git检查是否有.git目录）。如果是新项目，先git init；如果是克隆的仓库，用git clone重新克隆（git init会丢失远程关联和历史记录）
第七步：这些功能你也得知道
Fork （复制） 想研究某个项目，但不想直接改？点Fork，会在你账号下创建独立副本，你可以自由修改，不会直接影响原项目代码（但提交PR后原项目维护者会看到你的改动）。
Issue（问题） 用开源项目遇到bug了？去它的Issue区提问题。这也是跟开发者交流的渠道。
Pull Request（PR） 当你Fork了别人的项目，改好之后想合并回原项目？提交PR，等对方审核通过就能合并了。 这是开源协作的核心方式。
进阶技巧：GitHub Pages免费建站
**注意：免费版GitHub Pages只支持公开仓库。**如果仓库是私有的，需要升级到GitHub Pro或更高级别才能使用 Pages 。
操作步骤（界面可能随GitHub更新略有变化）：
在仓库里点"Settings"
左侧菜单找"Pages"
在"Build and deployment"区域，Source选"Deploy from a branch"
Branch下拉菜单选"main"，Folder保持"/ root "
确保仓库根目录下有 index.html 文件 （文件名必须全小写，不能是Index.html或其他变体），这是网站的入口页面，缺少它访问会404。
重要：如果部署前端框架打包项目（如Vite、 Vue 等） ，且文件名中有以下划线开头的（如_plugin-vue_export-helper.js），需要在仓库根目录运行touch .nojekyll创建一个空文件，让GitHub Pages跳过Jekyll处理，否则这些文件会被忽略导致404。
等几分钟，你的网站就上线了。地址通常是：
如果你的仓库名正好是 你的用户名.github.io（例如用户名是tony，仓库名也是tony.github.io），那地址就是
很多个人博客、技术文档都是这么搭建的，一分钱不用花。
不要怕命令行 。核心操作就这几个：clone/init、add、commit、push、pull。记住了就能用。
养成写commit习惯 。每次提交写清楚改了什么，以后回看历史很方便。
善用搜索 。遇到问题，先去GitHub的Issue区搜一搜，很可能早就有人遇到过并且解决了。
多看别人的项目 。GitHub上优质项目太多了，看别人怎么写代码、怎么管理项目进步很快。
全部评论