GitHub项目上传完全指南从零开始新手也能快速掌握的代码托管与版本控制技巧

威震华夏关云长 · 发表于 2025-8-22 16:10:45

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

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

x

GitHub项目上传完全指南从零开始新手也能快速掌握的代码托管与版本控制技巧

引言

在当今软件开发的世界中，版本控制和代码托管已成为开发者必备的技能。GitHub作为全球最大的代码托管平台，不仅提供了强大的版本控制功能，还为开发者提供了协作、项目管理和展示作品的平台。本指南将带领你从零开始，逐步掌握GitHub项目上传的完整流程，即使是完全没有经验的新手也能快速上手。

Git和GitHub的基础概念

Git是一个分布式版本控制系统，由Linux的创始人Linus Torvalds创建。它允许开发者跟踪文件的变化，协调多人之间的工作，并管理项目的不同版本。Git的主要优势包括：

• 分布式架构：每个开发者都有完整的代码副本
• 高效的性能：大多数操作都在本地执行
• 数据完整性：使用SHA-1哈希确保代码完整性
• 支持分支：轻松创建、合并和管理分支

GitHub则是一个基于Git的代码托管平台，提供了以下功能：

• 远程仓库存储
• 协作工具（Pull Request、Issue等）
• 项目管理功能
• 社交网络功能（关注、点赞等）
• 自动化部署和集成（GitHub Actions）

安装和配置Git

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

1. 访问Git官方网站：https://git-scm.com/
2. 下载Windows版本的Git安装程序
3. 运行安装程序，按照向导完成安装
4. 安装完成后，在命令提示符或PowerShell中输入以下命令验证安装：

git --version

复制代码

macOS用户可以通过以下几种方式安装Git：

使用Homebrew（推荐）：

brew install git

复制代码

使用Xcode Command Line Tools：

xcode-select --install

复制代码

Ubuntu/Debian：

sudo apt update
sudo apt install git

复制代码

Fedora：

sudo dnf install git

复制代码

安装完成后，你需要配置Git的用户信息，这些信息将用于每次提交的记录：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

复制代码

你还可以配置默认的文本编辑器：

git config --global core.editor "code --wait" # 使用VS Code作为编辑器

复制代码

查看所有配置：

git config --list

复制代码

GitHub账号注册与设置

1. 访问GitHub官网：https://github.com/
2. 点击右上角的”Sign up”按钮
3. 填写用户名、邮箱和密码
4. 选择验证邮箱并完成人机验证
5. 登录邮箱，点击验证链接
6. 完成账号注册后，你可以进一步完善个人资料

SSH密钥允许你在不输入密码的情况下安全地与GitHub通信。

检查是否已有SSH密钥：

ls -al ~/.ssh

复制代码

如果看到id_rsa.pub或id_ed25519.pub等文件，表示你已有SSH密钥。

生成新的SSH密钥：

ssh-keygen -t ed25519 -C "你的邮箱"

复制代码

按提示操作，可以使用默认路径和设置密码（可选）。

启动SSH代理并添加密钥：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

复制代码

将SSH公钥添加到GitHub账户：

1. 复制SSH公钥：

cat ~/.ssh/id_ed25519.pub

复制代码

1. 登录GitHub，点击右上角的头像，选择”Settings”
2. 在左侧菜单中选择”SSH and GPG keys”
3. 点击”New SSH key”，输入标题，粘贴复制的公钥
4. 点击”Add SSH key”完成添加

测试SSH连接：

ssh -T git@github.com

复制代码

如果看到”Hi username! You’ve successfully authenticated…“的消息，表示SSH连接已成功设置。

创建本地仓库

在将代码上传到GitHub之前，你需要在本地创建一个Git仓库。

1. 创建项目文件夹：

mkdir my-project
cd my-project

复制代码

1. 初始化Git仓库：

git init

复制代码

这会在当前目录下创建一个.git隐藏文件夹，用于存储Git的版本控制信息。

1. 创建一些文件，例如：

echo "# My Project" > README.md
echo "console.log('Hello, World!');" > index.js

复制代码

1. 查看仓库状态：

git status

复制代码

你会看到新创建的文件显示为”Untracked files”。

1. 将文件添加到暂存区：

git add README.md
git add index.js

复制代码

或者添加所有文件：

git add .

复制代码

1. 提交更改：

git commit -m "Initial commit: Add README and index.js"

复制代码

提交消息应该清晰描述本次更改的内容。

将代码上传到GitHub的详细步骤

现在，我们将把本地仓库的代码上传到GitHub。

1. 登录GitHub账户
2. 点击右上角的”+“图标，选择”New repository”
3. 填写仓库信息：Repository name: 输入仓库名称（例如”my-project”）Description（可选）: 输入仓库描述选择Public（公开）或Private（私有）
4. Repository name: 输入仓库名称（例如”my-project”）
5. Description（可选）: 输入仓库描述
6. 选择Public（公开）或Private（私有）
7. 不勾选”Add a README file”、”Add .gitignore”和”Add a license”（因为我们已经在本地创建了文件）
8. 点击”Create repository”按钮

• Repository name: 输入仓库名称（例如”my-project”）
• Description（可选）: 输入仓库描述
• 选择Public（公开）或Private（私有）

创建GitHub仓库后，你会看到一个仓库页面，其中包含仓库的URL。有两种URL可供选择：HTTPS和SSH。推荐使用SSH，因为之前我们已经配置了SSH密钥。

1. 复制SSH URL（格式为：git@github.com:username/my-project.git）
2. 在本地仓库中，添加远程仓库：

git remote add origin git@github.com:username/my-project.git

复制代码

这里，”origin”是远程仓库的默认名称，你可以使用其他名称，但”origin”是约定俗成的。

1. 验证远程仓库是否添加成功：

git remote -v

复制代码

现在，你可以将本地代码推送到GitHub：

git push -u origin master

复制代码

或者，如果你的Git版本较新，默认分支可能是”main”：

git push -u origin main

复制代码

-u参数将本地分支与远程分支关联起来，之后你可以简单地使用git push和git pull而不需要指定远程仓库和分支。

认证问题

如果你使用HTTPS而不是SSH，推送时可能会要求输入GitHub用户名和密码。较新的Git版本可能会要求使用个人访问令牌（Personal Access Token）而不是密码。

分支名称问题

如果GitHub上的默认分支与本地分支名称不同，可能会遇到错误。你可以使用以下命令重命名本地分支：

git branch -m master main

复制代码

常用Git命令详解

掌握以下常用Git命令将大大提高你的工作效率。

查看工作目录和暂存区的状态：

git status

复制代码

将文件添加到暂存区：

git add filename # 添加特定文件
git add directory/ # 添加特定目录
git add . # 添加所有修改和新建的文件
git add -u # 添加所有修改和删除的文件

复制代码

将暂存区的更改提交到本地仓库：

git commit -m "提交消息" # 简短提交
git commit -m "标题" -m "详细描述" # 多行提交消息
git commit -a -m "提交消息" # 跳过暂存步骤，提交所有已跟踪文件的更改
git commit --amend # 修改最后一次提交

复制代码

查看提交历史：

git log # 显示所有提交的详细信息
git log --oneline # 每个提交显示一行
git log --graph --oneline # 以图形方式显示分支和合并
git log -n 3 # 显示最近3个提交
git log --author="John" # 显示特定作者的提交

复制代码

查看文件差异：

git diff # 查看工作目录与暂存区的差异
git diff --staged # 查看暂存区与最新提交的差异
git diff commit1 commit2 # 查看两个提交之间的差异

复制代码

撤销操作：

git reset HEAD filename # 取消暂存文件
git reset --hard HEAD # 撤销所有未提交的更改
git reset --hard commit_id # 重置到特定提交，丢弃所有后续更改
git reset --soft commit_id # 重置到特定提交，但保留更改在暂存区

复制代码

撤销特定提交，创建一个新的提交：

git revert commit_id

复制代码

管理分支：

git branch # 列出所有分支
git branch branch_name # 创建新分支
git branch -d branch_name # 删除分支
git branch -D branch_name # 强制删除分支

复制代码

切换分支或恢复文件：

git checkout branch_name # 切换到特定分支
git checkout -b branch_name # 创建并切换到新分支
git checkout filename # 恢复文件到最新提交的状态

复制代码

合并分支：

git merge branch_name # 将指定分支合并到当前分支

复制代码

从远程仓库获取并合并更改：

git pull origin main # 从origin远程仓库的main分支拉取更改

复制代码

将本地提交推送到远程仓库：

git push origin main # 将本地main分支推送到origin远程仓库
git push -u origin main # 设置上游分支并推送
git push --all origin # 推送所有分支

复制代码

版本控制进阶技巧

Git Flow

Git Flow是一种流行的分支管理模型，适用于有计划发布的项目：

• main（或master）：主分支，始终保持可发布状态
• develop：开发分支，集成所有功能开发
• feature/：功能分支，从develop分出，用于开发新功能
• release/：发布分支，从develop分出，用于准备发布
• hotfix/：修复分支，从main分出，用于紧急修复

GitHub Flow

GitHub Flow是一种更简单的模型，适用于持续部署的项目：

• main（或master）：主分支，始终保持可部署状态
• 功能分支：从main分出，用于开发新功能或修复
• 通过Pull Request合并回main，并立即部署

当多人修改同一文件的同一部分时，会产生合并冲突。解决冲突的步骤如下：

1. 执行合并操作，Git会标记冲突文件：

git merge feature_branch

复制代码

1. 打开冲突文件，查找冲突标记（<<<<<<<、=======、>>>>>>>）：

function greeting() {
<<<<<<< HEAD
console.log("Hello, main!");
=======
console.log("Hello, feature!");
>>>>>>> feature_branch
}

复制代码

1. 编辑文件，解决冲突（选择保留的代码或合并两者）：

function greeting() {
console.log("Hello, everyone!");
}

复制代码

1. 保存文件，标记为已解决：

git add resolved_file.js

复制代码

1. 完成合并：

git commit

复制代码

查看提交历史

git log --oneline --graph --decorate --all

复制代码

交互式rebase

交互式rebase允许你修改、重新排序、合并或删除提交：

git rebase -i HEAD~3 # 修改最近3个提交

复制代码

这会打开一个编辑器，显示类似以下内容：

pick f7f3f6d Commit message 1
pick 310154e Commit message 2
pick a5f4a0d Commit message 3
# Rebase ...
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# . create a merge commit using the original merge commit's
# . message (or the oneline, if no original merge commit was
# . specified). Use -c <commit> to re-use the original merge
# . commit's author and message.
#
# These lines can be re-ordered; they are executed from top to bottom.

复制代码

你可以更改命令来修改提交历史。例如，将pick改为squash可以将该提交合并到前一个提交中。

重置提交

如果你想完全删除最近的提交：

git reset --hard HEAD~1 # 删除最近的提交及其更改
git reset --soft HEAD~1 # 删除最近的提交，但保留更改在暂存区

复制代码

团队协作技巧

在参与开源项目或团队协作时，通常使用Fork与Pull Request工作流：

1. Fork项目：在GitHub上点击”Fork”按钮，将项目复制到你的账户下
2. 克隆到本地：

git clone https://github.com/your-username/project-name.git
cd project-name

复制代码

1. 添加上游仓库：

git remote add upstream https://github.com/original-owner/project-name.git

复制代码

1. 创建功能分支：

git checkout -b feature-branch

复制代码

1. 进行更改并提交：

# 进行一些更改...
git add .
git commit -m "Add new feature"

复制代码

1. 推送到你的Fork：

git push origin feature-branch

复制代码

1. 创建Pull Request：在GitHub上，点击”New Pull Request”，选择你的分支和原始仓库的分支，填写描述并提交
2. 响应反馈：根据维护者的反馈进行修改并推送更新
3. 合并后更新本地分支：当Pull Request被合并后，更新你的本地仓库：

git checkout main
git pull upstream main
git push origin main

复制代码

作为审查者，以下是一些有效的代码审查技巧：

1. 关注代码逻辑而非风格：使用自动化工具检查代码风格
2. 提供建设性反馈：明确指出问题并建议解决方案
3. 确认测试覆盖：确保新代码有适当的测试
4. 检查安全性：查找潜在的安全漏洞
5. 关注性能：识别可能的性能瓶颈

作为被审查者，以下是一些建议：

1. 保持开放心态：将反馈视为学习机会
2. 及时响应：尽快处理审查意见
3. 解释决策：如果不同意某些建议，提供理由
4. 感谢反馈：表达对审查者时间的感谢

有效使用GitHub Issue可以大大提高团队协作效率：

1. 使用模板：为Bug报告、功能请求等设置Issue模板
2. 清晰描述：提供足够的上下文信息，包括重现步骤、预期行为和实际行为
3. 使用标签：为Issue分类，如”bug”、”enhancement”、”documentation”等
4. 分配负责人：明确谁负责处理特定Issue
5. 设置里程碑：将Issue组织到发布周期中
6. 关联Pull Request：将解决Issue的Pull Request与Issue关联起来

常见问题与解决方案

原因：远程仓库有本地没有的提交，通常是因为其他人在你推送之前已经推送了更改。

解决方案：

git pull origin main # 拉取远程更改
# 解决可能出现的冲突
git push origin main # 再次推送

复制代码

原因：当前目录不是Git仓库。

解决方案：

# 确保你在正确的目录中
pwd
# 如果需要，导航到正确的目录
cd path/to/repository
# 或者初始化新仓库
git init

复制代码

解决方案：

1. 从文件中移除敏感信息
2. 使用git filter-branch重写历史：

git filter-branch --force --index-filter \
'git rm --cached --ignore-unmatch filename-with-sensitive-data' \
--prune-empty --tag-name-filter cat -- --all

复制代码

1. 强制推送更新后的历史：

git push origin main --force

复制代码

1. 告知所有协作者：他们需要重新克隆仓库或执行复杂的rebase操作

注意：重写Git历史是一个危险操作，特别是在公共仓库中，应该谨慎使用。

解决方案：

1. 清理大文件历史：

# 查找大文件
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sed -n 's/^blob //p' | sort -nrk 2 | head -n 10
# 使用BFG Repo-Cleaner或git filter-branch移除大文件
java -jar bfg.jar --strip-blobs-bigger-than 100M my-repo.git

复制代码

1. 使用Git LFS（Large File Storage）：

# 安装Git LFS
git lfs install
# 跟踪大文件
git lfs track "*.psd"
git lfs track "*.zip"
# 提交.gitattributes文件
git add .gitattributes
git commit -m "Track large files with Git LFS"

复制代码

1. 考虑浅克隆：

git clone --depth 1 https://github.com/user/repo.git

复制代码

解决方案：

1. 使用交互式rebase整理提交：

git rebase -i HEAD~5

复制代码

1. 考虑使用git merge –squash：

git checkout main
git merge --squash feature-branch # 将所有更改合并但不提交
git commit -m "Consolidated feature changes"

复制代码

总结与最佳实践

1. 频繁提交：小而频繁的提交比大而罕见的提交更容易理解和回滚
2. 清晰的提交消息：使用简洁、描述性的提交消息，遵循约定格式
3. 分支策略：采用适合项目的分支策略，如Git Flow或GitHub Flow
4. 代码审查：在合并前进行代码审查，确保代码质量
5. 定期同步：定期从上游仓库拉取更改，减少合并冲突
6. 使用.gitignore：创建适当的.gitignore文件，避免提交不必要的文件
7. 备份重要数据：定期备份重要仓库，防止数据丢失

# 依赖目录
node_modules/
vendor/
# 构建输出
dist/
build/
out/
# 环境变量
.env
.env.local
.env.*.local
# 日志文件
logs/
*.log
# 运行时数据
pids/
*.pid
*.seed
*.pid.lock
# 编辑器目录和文件
.vscode/
.idea/
*.swp
*.swo
*~
# 操作系统生成的文件
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db

复制代码

类型(范围): 简短描述
详细描述（可选）
相关问题（可选）

复制代码

类型可以是：

• feat: 新功能
• fix: 修复bug
• docs: 文档更改
• style: 代码格式（不影响功能）
• refactor: 重构
• test: 添加或修改测试
• chore: 构建过程或辅助工具的变动

示例：

feat(auth): add user registration functionality
Implement user registration with email verification
Users can now register using their email address and will receive
a verification link to activate their account.
Closes #123

复制代码

1. 官方文档：Git文档GitHub文档
2. Git文档
3. GitHub文档
4. 交互式教程：Learn Git BranchingGitHub Skills
5. Learn Git Branching
6. GitHub Skills
7. 书籍：“Pro Git”（免费在线阅读）“GitHub in Action”
8. “Pro Git”（免费在线阅读）
9. “GitHub in Action”
10. 视频教程：GitHub官方YouTube频道各种在线学习平台的Git和GitHub课程
11. GitHub官方YouTube频道
12. 各种在线学习平台的Git和GitHub课程

官方文档：

• Git文档
• GitHub文档

交互式教程：

• Learn Git Branching
• GitHub Skills

书籍：

• “Pro Git”（免费在线阅读）
• “GitHub in Action”

视频教程：

• GitHub官方YouTube频道
• 各种在线学习平台的Git和GitHub课程

通过本指南，你已经掌握了GitHub项目上传的基本流程和版本控制的核心概念。记住，Git和GitHub是强大的工具，熟练使用它们需要时间和实践。不断学习和探索，你将能够更高效地管理代码和协作开发项目。

	通知：为庆祝网站一周年，将在5.1日与5.2日开放注册，具体信息请见后续详细公告	04-22 00:04
	通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，资源失效请在帖子内回复要求补档，会尽快处理！	10-23 09:31

活动公告

GitHub项目上传完全指南从零开始新手也能快速掌握的代码托管与版本控制技巧

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

浏览过的版块

立华奏

站长推荐 /1

友情链接

Telegram

Discord

Tencent QQ