在GitHub上创建第一个仓库！从初始化到推送的完全指南

通过之前的文章，我们完成了GitHub账户的创建和Git的安装，终于可以正式开始活用GitHub了。作为第一步，让我们来创建一个存放代码的“家”——仓库 (Repository)。

本文将从“仓库是什么？”这个基本概念开始，详细解释在GitHub上创建仓库的具体步骤，以及将您在电脑（本地环境）上创建的文件首次上传（推送）到GitHub的整个流程，并附上相应的命令。这个流程是未来开发中会反复进行的基本操作，请务必在此掌握！

仓库到底是什么？是您项目的“容器”

仓库 (Repository) 的字面意思是“储藏室”或“保管处”。在编程世界里，您可以把它看作是一个用于统一存放您项目所有相关文件（如HTML, CSS, JavaScript, 图片等）及其完整修改历史（提交日志）的“容器”。

仓库大致分为两种：

• 本地仓库 (Local Repository): 在您的电脑里创建的仓库。日常的工作都在这里进行。
• 远程仓库 (Remote Repository): 创建在像GitHub这样的互联网服务器上的仓库。它作为与团队成员共享代码以及个人代码备份的基地。

基本的开发流程是在本地仓库中进行工作，在合适的时机进行保存（提交），然后将这些修改内容上传（推送）到远程仓库，如此循环。

在GitHub上创建远程仓库的步骤

首先，让我们在GitHub上创建一个存放代码的远程仓库。步骤非常简单。

第一步：进入新建仓库页面
登录GitHub后，点击屏幕右上角的“+”图标，或者点击仪表板左侧的“New”按钮。

[图片：GitHub仪表板上的“New”按钮被高亮显示]

第二步：填写仓库信息
页面会跳转到“Create a new repository”，请在此填写必要信息。

[图片：解释“Create a new repository”表单中各项内容]

• Repository name: 仓库的名称。建议使用能说明项目内容的简洁英文名。（例如：`my-portfolio-site`）
• Description: 仓库的简短描述（可选）。写下项目简介有助于日后回顾时方便理解。
• Public / Private: 选择公开范围。如果希望全世界任何人都能看到，请选择“Public”；如果只想自己或被邀请的人看到，请选择“Private”。作为练习，选择“Private”即可。
• Initialize this repository with:: 创建仓库时可选择自动包含的文件。
  • Add a README file: 这是项目的说明文件。强烈建议勾选此项。
  • Add .gitignore: 用于指定希望Git忽略的文件的配置文件。现在可以暂时不选（None）。
  • Choose a license: 选择源代码的使用许可协议。个人使用的话，暂时不设置也没关系。

第三步：创建仓库
全部填写完毕后，点击“Create repository”按钮。这样，您在GitHub上的新远程仓库就创建成功了！

[图片：刚创建好的空仓库主页]

在本地电脑准备项目并连接到GitHub

接下来，让我们在您的电脑（本地）上准备一个项目，并将第一个文件上传到刚才创建的远程仓库吧。

第一步：在本地创建项目文件夹
首先，在您电脑上喜欢的位置创建一个工作文件夹。这里我们使用终端（Windows用户请使用Git Bash）进行操作。

mkdir my-first-repo

进入创建好的文件夹。

cd my-first-repo

第二步：初始化Git仓库
为了让这个文件夹被Git管理，需要执行初始化命令。执行后，文件夹内会生成一个名为`.git`的隐藏文件夹。

git init

第三步：创建要上传的文件
让我们创建一个简单的HTML文件用于测试。

echo "Hello, GitHub!" > index.html

第四步：提交文件（保存）
将创建的文件记录到Git中。首先，使用`git add`将文件选为保存对象（暂存）。

git add index.html

然后，使用`git commit`创建存档点。

git commit -m "添加初始HTML文件"

第五步：连接到远程仓库
将本地仓库与刚才在GitHub上创建的远程仓库关联起来。请前往您在GitHub上的仓库页面，点击“Code”按钮，然后复制SSH地址。

[图片：点击GitHub上的“Code”按钮并复制SSH地址的示意图]

git remote add origin git@github.com:your-username/my-first-repo.git

第六步：推送到GitHub（上传）
终于到了最后一步。将本地创建的提交上传到远程仓库。这个操作被称为“推送 (Push)”。

git push -u origin main

确认：检查文件是否已在GitHub上显示

推送完成后，请在浏览器中刷新您的GitHub仓库页面。您应该能看到刚才创建的`index.html`文件了！点击文件名还可以查看其内容。

[图片：GitHub仓库页面上，文件列表中已添加了index.html的示意图]

恭喜您！至此，您已经掌握了将本地文件上传到GitHub这一最基本且最重要的工作流程。