活动公告

系统通知
通知：关于部分勋章领取条件及购买价格调整的通知
05-18 21:22
系统通知
通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，资源失效请在帖子内回复要求补档，会尽快处理！
10-23 09:31
>社区 > 科技 > 经验交流 >帖子
本版发帖返回

GitHub项目导入完全手册 新手也能快速上手的代码托管教程 详细步骤与常见问题解答 让你的项目管理更高效

这是个蓝孩子 当前离线 威震华夏关云长
SunJu_FaceMall

3万

主题

2860

科技点

3万

积分

白金月票

碾压王

积分
32872

塔罗立华奏
<font color=白金月票" /> 发表于 2025-9-17 20:30:06 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要 登录 才可以下载或查看，没有账号？立即注册

x
引言

GitHub作为全球最大的代码托管平台，已经成为现代软件开发不可或缺的工具。它不仅提供了版本控制功能，还促进了开发者之间的协作与知识共享。本教程将带领您从零开始，逐步掌握GitHub的使用技巧，无论是个人项目管理还是团队协作，都能让您的开发工作更加高效。通过本手册，您将学会如何创建仓库、导入项目、管理代码版本以及解决常见问题，即使您是编程新手，也能轻松上手。

GitHub基础概念

在开始使用GitHub之前，了解一些基础概念是非常重要的。这些概念将帮助您更好地理解GitHub的工作原理，从而更高效地使用它。

什么是Git和GitHub？

Git是一个分布式版本控制系统，由Linux创始人Linus Torvalds创建。它允许您跟踪文件变化、回溯到之前的版本以及协作开发。而GitHub则是一个基于Git的云端托管平台，提供了图形界面和额外的协作功能，如问题跟踪、功能请求和项目管理工具。

核心概念解析

• 仓库（Repository）：仓库是项目的存储空间，包含项目的所有文件和每个文件的修订历史。它可以存储在本地（您的计算机上）或远程（如GitHub服务器上）。
• 提交（Commit）：提交是对项目某一时刻状态的快照。每次提交都会记录更改的内容、作者、时间以及提交信息。
• 分支（Branch）：分支允许您在不影响主代码线的情况下开发新功能或修复错误。默认分支通常是”main”或”master”。
• 克隆（Clone）：克隆是将远程仓库复制到本地的过程，使您能够在本地工作。
• 推送（Push）：推送是将本地提交上传到远程仓库的过程。
• 拉取（Pull）：拉取是从远程仓库获取最新更改并合并到本地仓库的过程。
• 拉取请求（Pull Request）：拉取请求是一种通知机制，用于告知团队成员您已经完成了一些更改，并请求他们审查和合并到主分支。

仓库（Repository）：仓库是项目的存储空间，包含项目的所有文件和每个文件的修订历史。它可以存储在本地（您的计算机上）或远程（如GitHub服务器上）。

提交（Commit）：提交是对项目某一时刻状态的快照。每次提交都会记录更改的内容、作者、时间以及提交信息。

分支（Branch）：分支允许您在不影响主代码线的情况下开发新功能或修复错误。默认分支通常是”main”或”master”。

克隆（Clone）：克隆是将远程仓库复制到本地的过程，使您能够在本地工作。

推送（Push）：推送是将本地提交上传到远程仓库的过程。

拉取（Pull）：拉取是从远程仓库获取最新更改并合并到本地仓库的过程。

拉取请求（Pull Request）：拉取请求是一种通知机制，用于告知团队成员您已经完成了一些更改，并请求他们审查和合并到主分支。

GitHub账号注册与设置

注册GitHub账号

要开始使用GitHub，首先需要创建一个账号：

1. 打开GitHub官网https://github.com
2. 点击右上角的”Sign up”按钮
3. 输入您的用户名、邮箱地址和密码
4. 选择是否接收产品更新和公告
5. 解决验证谜题以证明您不是机器人
6. 点击”Create account”按钮
7. 验证您的邮箱地址（检查收件箱中的验证邮件）

完善个人资料

注册完成后，建议您完善个人资料，这将帮助其他开发者更好地了解您：

1. 登录GitHub后，点击右上角的头像，选择”Settings”
2. 在”Profile”部分，您可以：上传头像添加姓名添加个人简介提供网站链接添加公司信息填写位置信息设置社交媒体链接
3. 上传头像
4. 添加姓名
5. 添加个人简介
6. 提供网站链接
7. 添加公司信息
8. 填写位置信息
9. 设置社交媒体链接

• 上传头像
• 添加姓名
• 添加个人简介
• 提供网站链接
• 添加公司信息
• 填写位置信息
• 设置社交媒体链接

账号安全设置

保护您的GitHub账号安全至关重要：

1. 在”Settings”中，选择”Password and authentication”
2. 启用双因素认证（2FA）：点击”Enable two-factor authentication”选择使用认证应用（如Google Authenticator）或短信验证按照提示完成设置
3. 点击”Enable two-factor authentication”
4. 选择使用认证应用（如Google Authenticator）或短信验证
5. 按照提示完成设置
6. 定期更新密码并确保密码强度足够高

• 点击”Enable two-factor authentication”
• 选择使用认证应用（如Google Authenticator）或短信验证
• 按照提示完成设置

Git安装与配置

安装Git

在使用GitHub之前，您需要在本地计算机上安装Git。

1. 访问Git官网https://git-scm.com/download/win
2. 下载最新的Git安装程序
3. 运行安装程序，按照提示完成安装（可以使用默认设置）
4. 安装完成后，打开命令提示符或PowerShell，输入以下命令验证安装：git --version如果显示Git版本号，则表示安装成功。
  2. git --version
复制代码

1. 如果您已安装Homebrew，可以通过以下命令安装Git：brew install git
2. 或者，访问Git官网https://git-scm.com/download/mac
3. 下载并安装最新的Git版本
4. 打开终端，输入以下命令验证安装：git --version
  2. brew install git
复制代码
  2. git --version
复制代码

对于不同的Linux发行版，安装命令可能有所不同：

•
  2. Debian/Ubuntu:sudo apt update
  3. sudo apt install git
复制代码
• Fedora:sudo dnf install git
• Arch Linux:sudo pacman -S git

Debian/Ubuntu:
  2. sudo apt update
  3. sudo apt install git
复制代码

Fedora:
  2. sudo dnf install git
复制代码

Arch Linux:
  2. sudo pacman -S git
复制代码

安装完成后，同样可以通过git --version命令验证安装。

配置Git

安装Git后，需要进行一些基本配置，以便在使用时正确标识您的身份：

1. 打开命令行工具（命令提示符、PowerShell或终端）
2. 设置您的用户名（与GitHub用户名相同或使用真实姓名）：git config --global user.name "您的用户名"
3. 设置您的邮箱地址（与GitHub注册邮箱相同）：git config --global user.email "您的邮箱地址"
4. 设置默认分支名称（GitHub现在默认使用”main”而非”master”）：git config --global init.defaultBranch main
5. （可选）设置Git默认编辑器：git config --global core.editor "编辑器名称"例如，使用VS Code作为默认编辑器：git config --global core.editor "code --wait"
6. 查看当前配置：git config --list

打开命令行工具（命令提示符、PowerShell或终端）

设置您的用户名（与GitHub用户名相同或使用真实姓名）：git config --global user.name "您的用户名"
  2. git config --global user.name "您的用户名"
复制代码

设置您的邮箱地址（与GitHub注册邮箱相同）：git config --global user.email "您的邮箱地址"
  2. git config --global user.email "您的邮箱地址"
复制代码

设置默认分支名称（GitHub现在默认使用”main”而非”master”）：git config --global init.defaultBranch main
  2. git config --global init.defaultBranch main
复制代码

（可选）设置Git默认编辑器：
  2. git config --global core.editor "编辑器名称"
复制代码

例如，使用VS Code作为默认编辑器：
  2. git config --global core.editor "code --wait"
复制代码

查看当前配置：
  2. git config --list
复制代码

配置SSH密钥

为了安全地与GitHub通信，建议设置SSH密钥认证：

1. 检查是否已有SSH密钥：ls -al ~/.ssh如果看到id_rsa和id_rsa.pub（或id_ed25519和id_ed25519.pub）文件，则表示已有SSH密钥。
2. 如果没有SSH密钥，生成新的SSH密钥：ssh-keygen -t ed25519 -C "您的邮箱地址"按照提示操作，可以使用默认设置，也可以为密钥设置密码。
3.
  2. 启动SSH代理并添加密钥：eval "$(ssh-agent -s)"
  3. ssh-add ~/.ssh/id_ed25519
复制代码
4. 将SSH公钥添加到GitHub账号：复制公钥内容：clip < ~/.ssh/id_ed25519.pub登录GitHub，点击右上角头像，选择”Settings”在左侧菜单中，点击”SSH and GPG keys”点击”New SSH key”按钮为密钥添加一个描述性标题将复制的公钥内容粘贴到”Key”字段点击”Add SSH key”保存
5. 复制公钥内容：clip < ~/.ssh/id_ed25519.pub
6. 登录GitHub，点击右上角头像，选择”Settings”
7. 在左侧菜单中，点击”SSH and GPG keys”
8. 点击”New SSH key”按钮
9. 为密钥添加一个描述性标题
10. 将复制的公钥内容粘贴到”Key”字段
11. 点击”Add SSH key”保存
12. 测试SSH连接：ssh -T git@github.com如果看到欢迎消息，则表示SSH配置成功。

检查是否已有SSH密钥：
  2. ls -al ~/.ssh
复制代码

如果看到id_rsa和id_rsa.pub（或id_ed25519和id_ed25519.pub）文件，则表示已有SSH密钥。

如果没有SSH密钥，生成新的SSH密钥：
  2. ssh-keygen -t ed25519 -C "您的邮箱地址"
复制代码

按照提示操作，可以使用默认设置，也可以为密钥设置密码。

启动SSH代理并添加密钥：
  2. eval "$(ssh-agent -s)"
  3. ssh-add ~/.ssh/id_ed25519
复制代码

将SSH公钥添加到GitHub账号：

• 复制公钥内容：clip < ~/.ssh/id_ed25519.pub
• 登录GitHub，点击右上角头像，选择”Settings”
• 在左侧菜单中，点击”SSH and GPG keys”
• 点击”New SSH key”按钮
• 为密钥添加一个描述性标题
• 将复制的公钥内容粘贴到”Key”字段
• 点击”Add SSH key”保存
  2. clip < ~/.ssh/id_ed25519.pub
复制代码

测试SSH连接：
  2. ssh -T git@github.com
复制代码

如果看到欢迎消息，则表示SSH配置成功。

创建新仓库并导入项目

在GitHub上创建新仓库

1. 登录GitHub账号
2. 点击右上角的”+“图标，选择”New repository”
3. 填写仓库信息：Repository name：为您的仓库起一个简洁明了的名称Description (optional)：添加仓库描述，简要说明项目内容Public/Private：选择仓库类型Public：任何人都可以查看此仓库Private：只有您和授权的用户可以查看此仓库Initialize this repository with：可以选择添加README文件、.gitignore文件或选择许可证点击”Create repository”按钮
4. Repository name：为您的仓库起一个简洁明了的名称
5. Description (optional)：添加仓库描述，简要说明项目内容
6. Public/Private：选择仓库类型Public：任何人都可以查看此仓库Private：只有您和授权的用户可以查看此仓库
7. Public：任何人都可以查看此仓库
8. Private：只有您和授权的用户可以查看此仓库
9. Initialize this repository with：可以选择添加README文件、.gitignore文件或选择许可证
10. 可以选择添加README文件、.gitignore文件或选择许可证
11. 点击”Create repository”按钮

• Repository name：为您的仓库起一个简洁明了的名称
• Description (optional)：添加仓库描述，简要说明项目内容
• Public/Private：选择仓库类型Public：任何人都可以查看此仓库Private：只有您和授权的用户可以查看此仓库
• Public：任何人都可以查看此仓库
• Private：只有您和授权的用户可以查看此仓库
• Initialize this repository with：可以选择添加README文件、.gitignore文件或选择许可证
• 可以选择添加README文件、.gitignore文件或选择许可证
• 点击”Create repository”按钮

• Public：任何人都可以查看此仓库
• Private：只有您和授权的用户可以查看此仓库

• 可以选择添加README文件、.gitignore文件或选择许可证

将本地项目导入GitHub仓库

1. 在本地计算机上，导航到您的项目文件夹：cd /path/to/your/project
2. 初始化本地Git仓库：git init
3. 添加所有文件到暂存区：git add .
4. 提交初始版本：git commit -m "Initial commit"
5. 在GitHub仓库页面，点击”Code”按钮，复制HTTPS URL（类似https://github.com/username/repo.git）
6. 添加远程仓库：git remote add origin https://github.com/username/repo.git
7. 推送代码到GitHub：git push -u origin main如果您的默认分支是”master”，则使用：git push -u origin master

在本地计算机上，导航到您的项目文件夹：
  2. cd /path/to/your/project
复制代码

初始化本地Git仓库：
  2. git init
复制代码

添加所有文件到暂存区：
  2. git add .
复制代码

提交初始版本：
  2. git commit -m "Initial commit"
复制代码

在GitHub仓库页面，点击”Code”按钮，复制HTTPS URL（类似https://github.com/username/repo.git）

添加远程仓库：
  2. git remote add origin https://github.com/username/repo.git
复制代码

推送代码到GitHub：
  2. git push -u origin main
复制代码

如果您的默认分支是”master”，则使用：
  2. git push -u origin master
复制代码

步骤与HTTPS方式类似，只需在第5步复制SSH URL（类似git@github.com:username/repo.git），然后在第6步使用该URL：
  2. git remote add origin git@github.com:username/repo.git
复制代码

其余步骤相同。

使用GitHub Desktop导入项目

如果您更喜欢图形界面，可以使用GitHub Desktop：

1. 下载并安装GitHub Desktop：https://desktop.github.com
2. 登录您的GitHub账号
3. 点击”File” > “Add Local Repository”，选择您的项目文件夹
4. 在顶部菜单中，点击”Publish repository”
5. 填写仓库名称、描述，选择Public/Private
6. 点击”Publish repository”按钮

克隆现有仓库

有时，您需要将GitHub上的现有仓库复制到本地进行工作，这个过程称为”克隆”。

使用HTTPS方式克隆

1. 在GitHub仓库页面，点击”Code”按钮
2. 确保选择了”HTTPS”选项卡
3. 复制URL（类似https://github.com/username/repo.git）
4. 在命令行中，导航到您想要存储项目的目录
5. 执行克隆命令：git clone https://github.com/username/repo.git
  2. git clone https://github.com/username/repo.git
复制代码

使用SSH方式克隆（推荐）

1. 在GitHub仓库页面，点击”Code”按钮
2. 选择”SSH”选项卡
3. 复制URL（类似git@github.com:username/repo.git）
4. 在命令行中，导航到您想要存储项目的目录
5. 执行克隆命令：git clone git@github.com:username/repo.git
  2. git clone git@github.com:username/repo.git
复制代码

使用GitHub Desktop克隆

1. 打开GitHub Desktop
2. 点击”File” > “Clone Repository”
3. 在URL选项卡中，粘贴仓库URL
4. 选择本地路径
5. 点击”Clone”按钮

基本Git命令与工作流程

掌握基本的Git命令是高效使用GitHub的关键。下面介绍最常用的Git命令及其工作流程。

查看仓库状态
  2. git status
复制代码

此命令显示工作目录和暂存区的状态，包括哪些文件已修改、哪些文件已暂存等。

添加文件到暂存区
  2. # 添加单个文件
  3. git add filename.txt
  5. # 添加所有修改的文件
  6. git add .
  8. # 添加所有修改和删除的文件
  9. git add -A
  11. # 交互式添加文件
  12. git add -i
复制代码

提交更改
  2. # 提交并添加简短描述
  3. git commit -m "提交信息"
  5. # 提交并添加详细描述（会打开编辑器）
  6. git commit
  8. # 修改最后一次提交（未推送到远程仓库）
  9. git commit --amend
复制代码

查看提交历史
  2. # 查看完整提交历史
  3. git log
  5. # 查看简洁的提交历史（单行显示）
  6. git log --oneline
  8. # 查看带图形化的提交历史
  9. git log --oneline --graph --all
  11. # 查看特定文件的提交历史
  12. git log filename.txt
复制代码

比较文件差异
  2. # 比较工作目录与暂存区的差异
  3. git diff
  5. # 比较暂存区与最新提交的差异
  6. git diff --staged
  8. # 比较工作目录与最新提交的差异
  9. git diff HEAD
  11. # 比较两个提交之间的差异
  12. git diff commit1 commit2
复制代码

分支操作
  2. # 查看所有分支
  3. git branch
  5. # 查看所有分支（包括远程分支）
  6. git branch -a
  8. # 创建新分支
  9. git branch new-branch
  11. # 切换到指定分支
  12. git checkout branch-name
  14. # 创建并切换到新分支
  15. git checkout -b new-branch
  17. # 删除本地分支
  18. git branch -d branch-name
  20. # 强制删除未合并的分支
  21. git branch -D branch-name
  23. # 重命名分支
  24. git branch -m old-name new-name
复制代码

远程仓库操作
  2. # 查看远程仓库
  3. git remote -v
  5. # 添加远程仓库
  6. git remote add remote-name url
  8. # 删除远程仓库
  9. git remote remove remote-name
  11. # 从远程仓库获取更改（不合并）
  12. git fetch remote-name
  14. # 从远程仓库获取并合并更改
  15. git pull remote-name branch-name
  17. # 推送更改到远程仓库
  18. git push remote-name branch-name
  20. # 设置上游分支并推送
  21. git push -u remote-name branch-name
复制代码

撤销操作
  2. # 撤销工作目录中的修改（恢复到暂存区状态）
  3. git checkout -- filename.txt
  5. # 撤销暂存区的修改（恢复到工作目录）
  6. git reset HEAD filename.txt
  8. # 撤销最后一次提交（保留修改）
  9. git reset --soft HEAD~1
  11. # 撤销最后一次提交（丢弃修改）
  12. git reset --hard HEAD~1
  14. # 撤销已推送到远程仓库的提交（创建新提交）
  15. git revert commit-id
复制代码

典型工作流程示例

假设您正在开发一个新功能，以下是典型的工作流程：

1. 确保您在最新的主分支上：git checkout main
git pull origin main
2. 创建一个新功能分支：git checkout -b feature/new-feature
3. 进行代码修改，然后添加并提交更改：git add .
git commit -m "添加新功能"
4. 如果需要继续修改，重复第3步
5. 完成开发后，将分支推送到远程仓库：git push origin feature/new-feature
6. 在GitHub上创建拉取请求（Pull Request），请求将您的功能分支合并到主分支
7. 根据审查意见进行修改并更新拉取请求
8. 合并拉取请求后，可以在本地删除功能分支：git checkout main
git pull origin main
git branch -d feature/new-feature

确保您在最新的主分支上：
  2. git checkout main
  3. git pull origin main
复制代码

创建一个新功能分支：
  2. git checkout -b feature/new-feature
复制代码

进行代码修改，然后添加并提交更改：
  2. git add .
  3. git commit -m "添加新功能"
复制代码

如果需要继续修改，重复第3步

完成开发后，将分支推送到远程仓库：
  2. git push origin feature/new-feature
复制代码

在GitHub上创建拉取请求（Pull Request），请求将您的功能分支合并到主分支

根据审查意见进行修改并更新拉取请求

合并拉取请求后，可以在本地删除功能分支：
  2. git checkout main
  3. git pull origin main
  4. git branch -d feature/new-feature
复制代码

团队协作功能

GitHub不仅是一个代码托管平台，还提供了丰富的团队协作功能，使多人开发变得更加高效。

拉取请求（Pull Request）

拉取请求是GitHub协作的核心功能，它允许您提议更改并请求他人审查和合并您的代码。

1. 在GitHub上，导航到您的仓库
2. 点击”Pull requests”选项卡
3. 点击”New pull request”按钮
4. 选择要合并的源分支和目标分支
5. 查看更改，确保一切正确
6. 填写拉取请求的标题和描述
7. 点击”Create pull request”按钮

作为审查者，您可以：

1. 查看代码更改
2. 发表评论（可以是行内评论或整体评论）
3. 批准更改或请求修改
4. 添加审查者
5. 将拉取请求分配给特定人员

当您收到反馈时：

1. 在本地进行必要的修改
2. 提交更改并推送到同一分支
3. 拉取请求会自动更新

问题（Issues）

GitHub的Issues功能允许您跟踪错误、功能请求和其他任务。

1. 在仓库页面，点击”Issues”选项卡
2. 点击”New issue”按钮
3. 填写标题和描述
4. 可以添加标签、里程碑和指派人员
5. 点击”Submit new issue”按钮

您可以使用标签、里程碑和项目板来组织问题：

• 标签：用于分类问题（如”bug”、”enhancement”、”question”）
• 里程碑：用于将问题分组到特定版本或时间点
• 项目板：用于创建看板式工作流程（如”To Do”、”In Progress”、”Done”）

Wiki

GitHub Wiki是一个简单的文档系统，适用于项目文档、使用指南等。

1. 在仓库页面，点击”Wiki”选项卡
2. 点击”Create the first page”按钮
3. 使用Markdown格式编写内容
4. 提供页面标题
5. 点击”Save page”按钮

您可以创建Wiki主页，并添加侧边栏导航，使文档结构更加清晰。

项目（Projects）

GitHub Projects提供了看板式项目管理功能，类似于Trello。

1. 在仓库页面，点击”Projects”选项卡
2. 点击”New project”按钮
3. 选择项目模板（如”Basic kanban”、”Automated kanban”等）
4. 为项目命名
5. 点击”Create project”按钮

您可以在项目中创建列（如”To Do”、”In Progress”、”Done”），然后将问题和拉取请求拖放到适当的列中。

保护分支

为了防止意外或未经授权的更改，您可以保护重要分支：

1. 在仓库页面，点击”Settings”选项卡
2. 在左侧菜单中，点击”Branches”
3. 在”Branch protection rules”部分，点击”Add rule”按钮
4. 输入要保护的分支名称（如”main”）
5. 选择保护选项，如：“Require pull request reviews before merging”“Require status checks to pass before merging”“Include administrators”
6. “Require pull request reviews before merging”
7. “Require status checks to pass before merging”
8. “Include administrators”
9. 点击”Create”按钮

• “Require pull request reviews before merging”
• “Require status checks to pass before merging”
• “Include administrators”

代码审查工具

GitHub提供了多种代码审查工具，帮助团队保持代码质量：

• 代码差异视图：清晰显示更改内容
• 行内评论：可以对特定代码行进行评论
• 建议修改：审查者可以直接建议代码修改
• 请求审查：可以指定特定人员审查代码

高级功能简介

除了基本的代码托管和协作功能外，GitHub还提供了许多高级功能，可以帮助您更高效地管理项目。

GitHub Actions

GitHub Actions是GitHub的CI/CD（持续集成/持续部署）平台，允许您自动化工作流程。

1. 在仓库中创建.github/workflows目录
2. 在该目录中创建一个YAML文件，如hello.yml
3. 添加以下内容：
  2. name: Hello World
  4. on: [push]
  6. jobs:
  7.   hello:
  8.     runs-on: ubuntu-latest
  9.     steps:
  10.       - name: Run a one-line script
  11.         run: echo "Hello, world!"
  12.       
  13.       - name: Run a multi-line script
  14.         run: |
  15.           echo "Add other actions to build,"
  16.           echo "test, and deploy your project."
复制代码

1. 提交并推送此文件
2. 在GitHub仓库中，点击”Actions”选项卡查看运行结果

自动运行测试：
  2. name: Run Tests
  4. on: [push, pull_request]
  6. jobs:
  7.   test:
  8.     runs-on: ubuntu-latest
  9.    
  10.     steps:
  11.     - uses: actions/checkout@v2
  12.    
  13.     - name: Set up Node.js
  14.       uses: actions/setup-node@v2
  15.       with:
  16.         node-version: '14'
  17.    
  18.     - name: Install dependencies
  19.       run: npm install
  20.    
  21.     - name: Run tests
  22.       run: npm test
复制代码

自动部署到GitHub Pages：
  2. name: Deploy to GitHub Pages
  4. on:
  5.   push:
  6.     branches: [ main ]
  8. jobs:
  9.   deploy:
  10.     runs-on: ubuntu-latest
  11.    
  12.     steps:
  13.     - uses: actions/checkout@v2
  14.    
  15.     - name: Set up Node.js
  16.       uses: actions/setup-node@v2
  17.       with:
  18.         node-version: '14'
  19.    
  20.     - name: Install dependencies
  21.       run: npm install
  22.    
  23.     - name: Build
  24.       run: npm run build
  25.    
  26.     - name: Deploy
  27.       uses: peaceiris/actions-gh-pages@v3
  28.       with:
  29.         github_token: ${{ secrets.GITHUB_TOKEN }}
  30.         publish_dir: ./build
复制代码

GitHub Pages

GitHub Pages允许您直接从GitHub仓库托管静态网站。

1. 在仓库页面，点击”Settings”选项卡
2. 在左侧菜单中，点击”Pages”
3. 在”Source”部分，选择部署源：可以从分支部署（如”main”分支的”/docs”文件夹）也可以使用GitHub Actions部署
4. 可以从分支部署（如”main”分支的”/docs”文件夹）
5. 也可以使用GitHub Actions部署
6. 点击”Save”按钮

• 可以从分支部署（如”main”分支的”/docs”文件夹）
• 也可以使用GitHub Actions部署

1. 在仓库中创建index.html文件：
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5.     <title>My GitHub Pages Site</title>
  6.     <style>
  7.         body {
  8.             font-family: Arial, sans-serif;
  9.             max-width: 800px;
  10.             margin: 0 auto;
  11.             padding: 20px;
  12.         }
  13.         h1 {
  14.             color: #0366d6;
  15.         }
  16.     </style>
  17. </head>
  18. <body>
  19.     <h1>Welcome to My GitHub Pages Site</h1>
  20.     <p>This is a simple static site hosted on GitHub Pages.</p>
  21. </body>
  22. </html>
复制代码

1. 提交并推送此文件
2. 按照上述步骤启用GitHub Pages
3. 几分钟后，访问提供的URL查看您的网站

GitHub Packages

GitHub Packages允许您直接在GitHub上托管软件包，支持多种包管理器。

1. 创建或编辑~/.npmrc文件，添加以下内容：
  2. //npm.pkg.github.com/:_authToken=TOKEN
复制代码

1. 创建或编辑项目的package.json文件，确保包含：
  2. {
  3.   "name": "@username/package-name",
  4.   "version": "1.0.0",
  5.   "publishConfig": {
  6.     "registry": "https://npm.pkg.github.com"
  7.   }
  8. }
复制代码

1. 登录到GitHub Packages：
  2. npm login --registry=https://npm.pkg.github.com
复制代码

1. 发布包：
  2. npm publish
复制代码

1. 创建或编辑项目的.npmrc文件，添加以下内容：
  2. @username:registry=https://npm.pkg.github.com
  3. //npm.pkg.github.com/:_authToken=TOKEN
复制代码

1. 安装包：
  2. npm install @username/package-name
复制代码

GitHub Codespaces

GitHub Codespaces提供了一个完整的、云托管的开发环境，您可以直接在浏览器中编辑代码。

1. 在仓库页面，点击”Code”按钮
2. 在”Codespaces”选项卡中，点击”New codespace”按钮
3. 等待环境创建完成

您可以通过在仓库中添加.devcontainer/devcontainer.json文件来自定义Codespaces环境：
  2. {
  3.   "name": "Node.js Sample",
  4.   "build": {
  5.     "dockerfile": "Dockerfile",
  6.     "context": ".."
  7.   },
  8.   "settings": {
  9.     "terminal.integrated.shell.linux": "/bin/bash"
  10.   },
  11.   "extensions": [
  12.     "dbaeumer.vscode-eslint"
  13.   ],
  14.   "forwardPorts": [3000],
  15.   "postCreateCommand": "npm install"
  16. }
复制代码

GitHub CLI

GitHub CLI是一个命令行工具，让您可以直接从终端与GitHub交互。

macOS:
  2. brew install gh
复制代码

Windows:

下载并运行最新的安装程序：https://github.com/cli/cli/releases/latest

Linux (Debian/Ubuntu):
  2. curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
  3. echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
  4. sudo apt update
  5. sudo apt install gh
复制代码

认证:
  2. gh auth login
复制代码

创建仓库:
  2. gh repo create new-repo --public --description "My new repository"
复制代码

克隆仓库:
  2. gh repo clone username/repo
复制代码

创建问题:
  2. gh issue create --title "Bug report" --body "This is a bug report"
复制代码

创建拉取请求:
  2. gh pr create --title "New feature" --body "Adds a new feature"
复制代码

常见问题解答

在使用GitHub和Git的过程中，您可能会遇到各种问题。本节将解答一些常见问题，帮助您解决困难。

Git相关常见问题

解答：

如果您想要撤销最后一次提交，但保留更改以便重新提交：
  2. git reset --soft HEAD~1
复制代码

如果您想要完全撤销最后一次提交，包括所有更改：
  2. git reset --hard HEAD~1
复制代码

如果您想要撤销多个提交，将HEAD~1中的数字替换为您想要撤销的提交数。

解答：

撤销已推送的更改需要谨慎，因为这会影响其他协作者。有几种方法：

1. 使用git revert创建新提交来撤销之前的更改（推荐）：git revert commit-id
git push origin branch-name
2. 使用git reset强制推送（仅适用于您确定不会影响其他人的情况）：git reset --hard commit-id
git push --force origin branch-name
3. 使用git rebase -i交互式地编辑提交历史：git rebase -i HEAD~n  # n是您想要查看的提交数在打开的编辑器中，将要删除的提交前面的pick改为drop，然后保存并退出。

使用git revert创建新提交来撤销之前的更改（推荐）：
  2. git revert commit-id
  3. git push origin branch-name
复制代码

使用git reset强制推送（仅适用于您确定不会影响其他人的情况）：
  2. git reset --hard commit-id
  3. git push --force origin branch-name
复制代码

使用git rebase -i交互式地编辑提交历史：
  2. git rebase -i HEAD~n  # n是您想要查看的提交数
复制代码

在打开的编辑器中，将要删除的提交前面的pick改为drop，然后保存并退出。

解答：

合并冲突发生在Git无法自动合并两个分支的更改时。解决步骤如下：

1.
  2. 当出现合并冲突时，Git会提示您：git merge branch-name
  3. Auto-merging file.txt
  4. CONFLICT (content): Merge conflict in file.txt
  5. Automatic merge failed; fix conflicts and then commit the result.
复制代码
2. 打开有冲突的文件，您会看到类似这样的标记：<<<<<<< HEAD
这是当前分支的内容
=======
这是要合并的分支的内容
>>>>>>> branch-name
3. 编辑文件，保留您想要的内容，删除冲突标记。
4. 添加已解决的文件：git add file.txt
5. 完成合并：git commit

当出现合并冲突时，Git会提示您：
  2. git merge branch-name
  3. Auto-merging file.txt
  4. CONFLICT (content): Merge conflict in file.txt
  5. Automatic merge failed; fix conflicts and then commit the result.
复制代码

打开有冲突的文件，您会看到类似这样的标记：
  2. <<<<<<< HEAD
  3. 这是当前分支的内容
  4. =======
  5. 这是要合并的分支的内容
  6. >>>>>>> branch-name
复制代码

编辑文件，保留您想要的内容，删除冲突标记。

添加已解决的文件：
  2. git add file.txt
复制代码

完成合并：
  2. git commit
复制代码

解答：

如果您删除了文件但尚未提交，可以使用以下命令恢复：
  2. git checkout -- filename.txt
复制代码

如果您已经提交了删除操作，可以使用以下方法恢复：

1. 找到文件最后一次存在的提交：git log --follow -- filename.txt
2. 从该提交恢复文件：git checkout commit-id -- filename.txt
3. 添加恢复的文件并提交：git add filename.txt
git commit -m "恢复误删的文件"

找到文件最后一次存在的提交：
  2. git log --follow -- filename.txt
复制代码

从该提交恢复文件：
  2. git checkout commit-id -- filename.txt
复制代码

添加恢复的文件并提交：
  2. git add filename.txt
  3. git commit -m "恢复误删的文件"
复制代码

解答：

您可以使用git show命令查看特定提交的详细信息：
  2. git show commit-id
复制代码

如果您只想查看特定文件的更改：
  2. git show commit-id:filename.txt
复制代码

或者，使用git diff比较两个提交之间的差异：
  2. git diff commit-id1 commit-id2
复制代码

GitHub相关常见问题

解答：

这个错误通常表示SSH密钥配置有问题。解决步骤如下：

1. 检查SSH密钥是否存在：ls -al ~/.ssh
2. 如果没有SSH密钥，生成一个新的：ssh-keygen -t ed25519 -C "your_email@example.com"
3.
  2. 启动SSH代理并添加密钥：eval "$(ssh-agent -s)"
  3. ssh-add ~/.ssh/id_ed25519
复制代码
4. 将公钥添加到GitHub：复制公钥：cat ~/.ssh/id_ed25519.pub登录GitHub，进入”Settings” > “SSH and GPG keys”点击”New SSH key”，粘贴公钥内容
5. 复制公钥：cat ~/.ssh/id_ed25519.pub
6. 登录GitHub，进入”Settings” > “SSH and GPG keys”
7. 点击”New SSH key”，粘贴公钥内容
8. 测试SSH连接：ssh -T git@github.com

检查SSH密钥是否存在：
  2. ls -al ~/.ssh
复制代码

如果没有SSH密钥，生成一个新的：
  2. ssh-keygen -t ed25519 -C "your_email@example.com"
复制代码

启动SSH代理并添加密钥：
  2. eval "$(ssh-agent -s)"
  3. ssh-add ~/.ssh/id_ed25519
复制代码

将公钥添加到GitHub：

• 复制公钥：cat ~/.ssh/id_ed25519.pub
• 登录GitHub，进入”Settings” > “SSH and GPG keys”
• 点击”New SSH key”，粘贴公钥内容
  2. cat ~/.ssh/id_ed25519.pub
复制代码

测试SSH连接：
  2. ssh -T git@github.com
复制代码

解答：

这个错误表示您尝试添加一个名为”origin”的远程仓库，但它已经存在。您有几个选择：

1. 如果您想要更改现有的远程仓库URL：git remote set-url origin new-url
2. 如果您想要删除现有的远程仓库并添加新的：git remote remove origin
git remote add origin new-url
3. 如果您想要保留现有的远程仓库但添加另一个，使用不同的名称：git remote add upstream new-url

如果您想要更改现有的远程仓库URL：
  2. git remote set-url origin new-url
复制代码

如果您想要删除现有的远程仓库并添加新的：
  2. git remote remove origin
  3. git remote add origin new-url
复制代码

如果您想要保留现有的远程仓库但添加另一个，使用不同的名称：
  2. git remote add upstream new-url
复制代码

解答：

这个错误表示远程仓库有您本地没有的提交。解决方法是先获取远程更改，然后合并：
  2. git fetch origin
  3. git merge origin/main
复制代码

或者，更简单的方法是使用git pull：
  2. git pull origin main
复制代码

如果存在冲突，您需要解决冲突后再推送。

解答：

删除GitHub仓库是不可逆操作，请谨慎操作：

1. 在GitHub上，导航到要删除的仓库
2. 点击”Settings”选项卡
3. 滚动到页面底部的”Danger Zone”
4. 点击”Delete this repository”
5. 输入仓库名称确认删除
6. 点击”I understand the consequences, delete this repository”按钮

解答：

当GitHub Actions失败时，可以按以下步骤排查：

1. 在仓库中，点击”Actions”选项卡
2. 找到失败的工作流程并点击
3. 查看运行日志，找出错误信息
4. 根据错误信息修复问题
5. 如果需要，可以重新运行工作流程

常见问题包括：

• 依赖安装失败：检查package.json或依赖文件是否正确
• 脚本执行错误：检查脚本语法和路径是否正确
• 权限问题：确保工作流程有足够的权限执行操作
• 环境变量缺失：检查是否需要设置secrets或环境变量

解答：

这个提示表示您的本地分支有一个提交尚未推送到远程仓库。解决方法很简单：
  2. git push origin main
复制代码

如果您不想要这个提交，可以撤销它：
  2. git reset --hard HEAD~1
复制代码

解答：

迁移GitHub仓库的步骤如下：

1. 在新账户或组织中创建一个空仓库
2. 在本地，克隆原始仓库（使用–bare选项）：git clone --bare https://github.com/username/original-repo.git
3. 进入克隆的目录：cd original-repo.git
4. 镜像推送到新仓库：git push --mirror https://github.com/new-username/new-repo.git
5. 删除本地克隆的仓库：cd ..
rm -rf original-repo.git
6. 克隆新仓库到本地进行工作：git clone https://github.com/new-username/new-repo.git

在新账户或组织中创建一个空仓库

在本地，克隆原始仓库（使用–bare选项）：
  2. git clone --bare https://github.com/username/original-repo.git
复制代码

进入克隆的目录：
  2. cd original-repo.git
复制代码

镜像推送到新仓库：
  2. git push --mirror https://github.com/new-username/new-repo.git
复制代码

删除本地克隆的仓库：
  2. cd ..
  3. rm -rf original-repo.git
复制代码

克隆新仓库到本地进行工作：
  2. git clone https://github.com/new-username/new-repo.git
复制代码

总结与最佳实践

通过本教程，您已经学习了如何使用GitHub进行项目管理和代码托管。从创建账号、配置Git，到创建仓库、导入项目，再到团队协作和高级功能的使用，您现在应该能够自信地使用GitHub来管理您的项目。

最佳实践总结

为了帮助您更高效地使用GitHub，以下是一些最佳实践建议：

好的提交信息应该清晰、简洁地描述更改内容：
  2. # 好的提交信息
  3. git commit -m "添加用户认证功能：实现登录和注册API"
  5. # 不好的提交信息
  6. git commit -m "修复bug"
复制代码

在开始新功能开发之前，确保您的本地主分支是最新的：
  2. git checkout main
  3. git pull origin main
复制代码

为每个新功能或修复创建单独的分支：
  2. git checkout -b feature/user-authentication
复制代码

每个提交应该只关注一个逻辑更改，这样更容易审查和回滚。

定期将您的代码推送到远程仓库，以防止本地代码丢失：
  2. git push origin feature-branch
复制代码

在合并代码之前，始终使用拉取请求进行代码审查：
  2. # 完成功能开发后
  3. git push origin feature-branch
  4. # 然后在GitHub上创建拉取请求
复制代码

创建.gitignore文件来忽略不需要版本控制的文件：
  2. # .gitignore
  3. node_modules/
  4. .env
  5. dist/
  6. *.log
  7. .DS_Store
复制代码

使用标签标记发布版本：
  2. git tag -a v1.0.0 -m "版本1.0.0发布"
  3. git push origin v1.0.0
复制代码

对于重要仓库，考虑定期备份：
  2. git clone --mirror https://github.com/username/repo.git
复制代码

使用GitHub Issues跟踪错误、功能请求和其他任务，并适当使用标签和里程碑进行组织。

持续学习

GitHub和Git生态系统不断发展，新的功能和工具不断涌现。为了保持您的技能更新，建议您：

1. 关注GitHub博客和官方文档
2. 参与开源项目，学习他人的工作流程
3. 尝试使用GitHub的高级功能，如GitHub Actions、GitHub Packages等
4. 加入GitHub社区，参与讨论和问答

结语

GitHub是一个强大的工具，它不仅可以帮助您管理代码，还可以促进团队协作和项目管理。通过掌握本教程中介绍的概念和技能，您已经迈出了成为高效开发者的关键一步。无论您是个人开发者还是团队成员，GitHub都能帮助您更好地组织工作、提高效率并创建出色的软件。

希望本教程能够帮助您顺利入门GitHub，并在您的开发旅程中提供持续的指导和支持。祝您使用愉快！
存储空间
「七転び八起き（ななころびやおき）」
回复

使用道具 举报

返回列表 发新帖
您需要登录后才可以回帖 登录 | 立即注册
高级模式
B Color Image Link Quote Code Smilies

本版积分规则