1129 words
6 minutes
关于github的一些使用方法
2025-11-12

GitHub 是一个面向开源及私有软件项目的托管平台,因为只支持 Git 作为唯一的版本库格式进行托管,故名 GitHub。它不仅是代码仓库,还是一个强大的协作工具。本文将介绍一些 GitHub 的基本使用方法。

准备工作:安装 Git#

在开始使用 GitHub 之前,你的电脑上需要安装 Git。Git 是一个免费、开源的分布式版本控制系统,是与 GitHub 交互的基础。

你可以从 Git 官网 下载适合你操作系统的安装包。安装过程通常很简单,保持默认设置即可。

安装完成后,你可以在终端(Windows 上的 PowerShell 或 CMD,macOS/Linux 上的 Terminal)中输入以下命令来验证 Git 是否安装成功:

Terminal window
git --version

如果能看到版本号,说明 Git 已经成功安装。

核心概念#

在开始使用 GitHub 之前,了解一些核心概念非常重要:

  • 仓库 (Repository): 你的项目存放的地方。可以想象成一个项目的文件夹,里面包含了项目的所有文件和修订历史。
  • 克隆 (Clone): 将远程仓库复制到你的本地计算机上。
  • 提交 (Commit): 将你的代码更改保存到本地仓库。每次提交都有一个唯一的 ID 和一条描述信息。
  • 推送 (Push): 将本地仓库的提交上传到远程仓库(例如 GitHub)。
  • 拉取 (Pull): 从远程仓库获取最新的更改并合并到你的本地仓库。
  • 分支 (Branch): 为了在不影响主线(通常是 mainmaster 分支:这几年估计都改成了main,说是master有奇怪的隐喻😅)开发的情况下进行功能开发或修复 bug,你可以创建一个分支。开发完成后,再将分支合并到主线。
  • 拉取请求 (Pull Request / PR): 当你希望将你的分支合并到另一个分支时,你可以创建一个拉取请求。这是一个请求审查和讨论你的代码更改的地方。
  • 合并 (Merge): 将一个分支的更改合并到另一个分支。

基本工作流程#

1. 创建一个新的仓库#

  1. 登录你的 GitHub 账户。
  2. 点击右上角的 ”+” 图标,然后选择 “New repository”。
  3. 为你的仓库命名,添加一个可选的描述。
  4. 选择 “Public”(公开)或 “Private”(私有)。
  5. 你可以选择使用 README 文件、.gitignore 文件和许可证来初始化仓库。
  6. 点击 “Create repository”。

2. 克隆仓库到本地#

要对仓库进行更改,你需要先把它克隆到你的电脑上。

Terminal window
git clone https://github.com/your-username/your-repository.git

your-usernameyour-repository 替换为你的 GitHub 用户名和仓库名。

3. 添加和提交更改#

在本地对项目文件进行修改后,你需要将这些更改提交到本地仓库。

Terminal window
# 进入仓库目录
cd your-repository
# 查看文件状态
git status
# 添加所有更改的文件到暂存区
git add .
# 提交更改,并附上描述信息
git commit -m "你的提交信息,例如:添加了新功能"

4. 推送更改到 GitHub#

提交到本地仓库后,你需要将这些更改推送到 GitHub 上的远程仓库。

Terminal window
git push origin main

(main 可能是你的主分支名,也可能是 master)

分支与协作#

分支是 GitHub 协作的核心。

1. 创建并切换到新分支#

Terminal window
# 创建一个名为 feature-x 的新分支并切换过去
git checkout -b feature-x

2. 推送新分支到 GitHub#

在你的新分支上进行提交后,将该分支推送到远程仓库。

Terminal window
git push origin feature-x

3. 创建拉取请求 (Pull Request)#

  1. 在 GitHub 上你的仓库页面,你会看到一个提示,可以为 feature-x 分支创建一个拉取请求。
  2. 点击 “Compare & pull request”。
  3. 填写标题和描述,说明你的更改内容。
  4. 点击 “Create pull request”。

之后,项目维护者可以审查你的代码,提出修改意见,最后将其合并到主分支中。

GitHub Pages#

GitHub Pages 是 GitHub 提供的一个静态网站托管服务。你可以用它来托管你的个人博客、项目文档等。

  1. 确保你的仓库中有一个 index.html 文件。
  2. 进入仓库的 “Settings” 页面。
  3. 在左侧菜单中选择 “Pages”。
  4. 在 “Source” 部分,选择你想要部署的分支(通常是 main)。
  5. 保存后,GitHub 会为你的网站生成一个 URL,格式通常是 https://your-username.github.io/your-repository/

希望这篇指南能帮助你更好地开始使用 GitHub!