Github 简单入门指南：从零开始托管你的第一个项目

littleblackLB

什么是代码托管平台?  
代码托管平台是一种面向软件开发者的基于Git 的在线代码托管服务，它提供了一个云端的代码仓库，旨在解决软件开发者在跨地域协同、多分支并发、代码版本管理、安全性等方面的问题。
由于本帖是用于快速入门 GitHub 的简单入门指南，因此我会刻意省略一些配置项的阐释，你可以仔细搜索学习。

为什么选择 Github?
在学习代码托管平台时，你可能会听说多个选择：GitHub、Gitee、Coding.net 等。作为初学者，我们可以从集合关系的角度来看待它们的定位：

  GitHub 是一个功能、生态与影响力都远超 Gitee 等平台的“超集平台”。

具体来说：

维度	GitHub	Gitee / 其他
用户量	全球最大，覆盖上亿开发者	主要服务国内用户
项目质量	涵盖全球顶级开源项目（如 Linux、React、Stable Diffusion）	以个人项目、中小企业内网项目为主
教学资源	大量高校课程与科研项目原始仓库	教学资源较少
工具生态	完整支持 GitHub Actions、Copilot、API 自动化	生态相对封闭，集成不多
行业认可	是简历中的加分项，是工程师的“作品集”平台	在国际视野下影响较小

因此，在我看来，Gitee 与 GitHub 之间并非“谁更好”的问题，而是“谁的集合更大、更有成长潜力”。GitHub 涵盖了绝大多数主流项目的协作需求，而 Gitee 更多是 GitHub 的一个子集式替代方案，在特定场景（如企业私有部署、国内加速访问）下有优势。
如果你希望：

• 追踪全球开源动态
• 与最前沿技术保持同步
• 为简历加分，展示项目能力
  

与此同时学习了 GitHub 的用法后，你也可以轻松的使用其它的托管平台，因此 GitHub 是不二之选。

Git 和 GitHub 的关系：工具 与 平台
在进入 GitHub 的使用之前，我们必须先搞清楚这两个名词的区别和联系：

项目	Git	GitHub
类型	工具	平台 / 网站
本质	一个分布式版本控制系统	一个基于 Git 的代码托管与协作平台
开发者	Linus Torvalds（Linux 之父）等开源社区	Microsoft（2018 年收购）
工作环境	本地命令行或图形界面	在线网站、远程仓库
主要用途	管理和记录代码变更历史	托管项目、协作开发、展示作品集
是否联网	不需要联网即可使用本地 Git	依赖互联网访问（除 GitHub CLI 工具）

举个比喻：你可以把 Git 看作是一把强大的“本地版控制工具”，它能帮你在本地机器上：

• 创建版本快照（commit）
• 分支开发
• 回滚历史
  

而 GitHub 是一个“托管平台”，你可以：

• 上传你的 Git 项目
• 与他人协作开发（pull request、issues、review）
• 展示你的作品，供他人学习或使用
  

就像你可以在自己的电脑上写作（Git），但如果你希望别人看到、编辑、甚至一起合著这篇文章，你就会上传到一个公共协作文档平台（GitHub）。

账号注册
略…

创建自己的项目
  1. 点击左上的  按钮

  2. 在创建仓库页面中填写信息



安装 Git

• 从 https://git-scm.com/  下载并安装 Git
• 如果你能在命令行中输入git后有正常回显则成功!
  

绑定 Git 与 GitHub

• 进入命令行
• ssh-keygen -t rsa -C "github auth key"
• 进入 %userprpfile%\.ssh，打开并复制 id_rsa.pub中的内容，
• 进入 https://github.com/settings/keys ，点开
  

   5. 回到命令行，输入 ssh -T git@github.com

• 如果出现Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.，则成功。
• 如果出现Connection closed by xxx port 22，则尝试关掉科学上网软件并多试几次。
  

   6. 分别设置下列两个配置

• git config --global user.name "你的用户名"
• git config --global user.email "GitHub 注册邮箱"
  

提交代码文件至远程 GitHub 仓库

• 克隆仓库: git clone git@github.com:xxx/test.git
  

> git clone git@github.com:xxx/test.git  
Cloning into 'test'...  
remote: Enumerating objects: 3, done.  
remote: Counting objects: 100% (3/3), done.  
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)  
Receiving objects: 100% (3/3), done.
> cd test
> # 2. 此时你可以在这个目录中创建若干个文本(代码)文件
> git status
On branch main  
Your branch is up to date with 'origin/main'.  
  
Untracked files:  
(use "git add <file>..." to include in what will be committed)  
       main.py  
  
nothing added to commit but untracked files present (use "git add" to track)
> # 3. 将所有文件添加到索引(暂存)区中
> git add .
> # 4. 将代码提交到本地仓库中
> git commit -m "My first commit"
[main 61bfd9e] My first commit  
1 file changed, 2 insertions(+)  
create mode 100644 main.py
> # 5. 推送至远程仓库
> git push origin main
Enumerating objects: 4, done.  
Counting objects: 100% (4/4), done.  
Delta compression using up to 16 threads  
Compressing objects: 100% (2/2), done.  
Writing objects: 100% (3/3), 1.21 KiB | 1.21 MiB/s, done.  
Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)  
To github.com:littleblacklb/test.git  
  f986916..61bfd9e  main -> main


写在最后
至此，你已经完成了使用 Git 和 GitHub 的基本入门流程。从本地创建项目、编写代码，到将其推送至云端仓库，你迈出了走向现代协作式开发的重要一步。未来无论是参与开源社区、搭建个人项目作品集，还是在简历中展示你的工程能力，这一技能都将成为你不可或缺的“硬核”资产。
记住，Git 和 GitHub 不仅是工具，更是一种开发者的思维方式：注重版本管理、强调协作效率、拥抱公开透明的开发文化。
愿你以此为起点，构建属于自己的项目宇宙。

  “Talk is cheap. Show me the code.”
  —— Linus Torvalds