GitHub基础

一句话：GitHub是代码托管和协作平台，常用于保存项目、发布开源代码和管理开发任务。

它是什么

GitHub可以理解成放代码的云盘加协作系统。你可以把本地Git项目上传到GitHub，和别人协作，提交Issue，创建Pull Request，查看历史变更。很多AI编程工具也会读取GitHub仓库来理解项目。

适合干什么

• 想备份代码的人
• 学习开源项目的人
• 使用Codex或Claude Code管理项目的人
• 需要和开发者协作的人

不适合干什么

• 不想公开代码且不会设置私有仓库的人
• 包含敏感商业代码但没有权限管理的人

普通人怎么用

• 注册GitHub账号
• 创建仓库
• 把本地项目push上去
• 写README说明项目
• 用Issue记录待办

进阶用户怎么用

• 用分支开发新功能
• 用Pull Request做代码审查
• 用Actions自动测试和部署
• 用Release发布版本

常见误区

• 把私密代码建成公开仓库
• 上传密钥、数据库密码和配置文件
• README不写项目说明
• 所有任务都只在聊天里说，没有Issue记录

和相似工具的区别

• GitHub vs Git：Git是本地版本管理工具，GitHub是远程托管和协作平台。
• Issue vs Pull Request：Issue用于记录问题和任务，Pull Request用于提交代码变更并接受审查。

入门步骤

• 创建新仓库
• 复制远程仓库地址
• 本地绑定remote
• 执行git push
• 检查GitHub页面是否出现代码

推荐工具（第三方）

GitHub、Git、VS Code、Cursor、Codex、Claude Code