GitHub 是什么：创建第一个可协作的代码仓库

Git 是本地版本控制工具；GitHub 是围绕远程仓库、讨论和审查建立的协作平台。一个清晰的 README 与可复现的启动方式，往往比漂亮主页更早建立信任。

你会学到什么

• 区分 Git 与 GitHub 的职责。

• 创建带 README 的远程仓库。

• 了解 Issue 和 Pull Request 在协作中的位置。

动手步骤

• 在 GitHub 创建仓库并添加 README。

• 在 README 写明用途、安装、运行与最小示例。

• 用 Issue 记录可讨论的问题与完成标准。

• 用 Pull Request 承载一个可审查的修改。

最小示例

git clone <repository-url>
cd <repository-name>
echo "项目说明" >> README.md
git add README.md && git commit -m "docs: explain project"
git push origin main

容易踩坑的地方

• 只上传代码而没有启动说明，会让使用者无法验证项目。

• 不要把令牌、私钥或 .env 推到远程。

• 不要绕过 PR 直接把试验性代码推送到 main。

完成前检查

• README 含启动命令。

• 仓库有 .gitignore。

• 每个 PR 都说明验证方式。

延伸阅读

• GitHub Docs：Start your journey：https://docs.github.com/en/get-started/start-your-journey

• GitHub Docs：Getting started with Git：https://docs.github.com/en/get-started/learning-to-code/getting-started-with-git