GitHub 仓库管理完整教程
本教程覆盖 Git 安装配置、SSH 密钥设置、仓库创建、项目上传及后续维护的完整流程。
从零开始使用 GitHub 仓库的完整流程。内容包括安装 Git 客户端、配置全局用户信息及 SSH 密钥、在 GitHub 创建远程仓库、将本地项目初始化为 Git 仓库并首次推送。此外还涵盖了后续的代码更新、分支管理、远程同步与冲突解决等常见操作,以及 .gitignore 配置和安全验证注意事项。通过,开发者可以掌握将本地项目上传至 GitHub 并保持版本同步的基本技能。

本教程覆盖 Git 安装配置、SSH 密钥设置、仓库创建、项目上传及后续维护的完整流程。
Windows:
.exe 安装包,双击运行,保持默认设置完成安装。macOS:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git
Linux(以 Ubuntu 为例): 打开终端执行:
sudo apt update
sudo apt install git -y
安装完成后,在终端输入以下命令检查版本:
git --version
若输出类似 git version 2.x.x,说明安装成功。
依次执行以下命令配置提交者信息:
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"
user.name:填写 GitHub 注册的用户名或昵称。user.email:填写与 GitHub 账号绑定的邮箱地址。配置完毕后,可用以下命令检查:
git config --global --list
使用 SSH 方式推送代码可避免每次输入密码。
执行以下命令生成密钥(一路回车即可):
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
默认生成 .ssh/id_ed25519(私钥)和 .ssh/id_ed25519.pub(公钥)。
查看公钥内容:
cat ~/.ssh/id_ed25519.pub
复制输出的字符串(以 ssh-ed25519 开头)。
ssh -T [email protected]
若提示 Hi <用户名>! You've successfully authenticated...,则配置成功。+,选择 New repository。my-project)。假设本地项目路径为 ~/projects/my-project。
切换到项目目录:
cd ~/projects/my-project
执行初始化:
git init
将所有文件加入暂存区:
git add .
提交更改:
git commit -m "首次提交:项目初始化"
若主分支名为 master,建议重命名为 main 以符合通用约定:
git branch -M main
将远程地址添加为 origin:
# 使用 SSH
git remote add origin [email protected]:你的用户名/my-project.git
# 或使用 HTTPS
# git remote add origin https://github.com/你的用户名/my-project.git
确认关联:
git remote -v
建立跟踪关系并推送:
git push -u origin main
若分支为 master,则使用 git push -u origin master。
推送成功后,刷新 GitHub 仓库页面即可查看文件。
修改或新增文件后:
git add .
git commit -m "本次更新:简要说明修改内容"
git push
由于已建立跟踪关系,后续只需 git push。
多人协作时,远程可能有新提交。推送前先拉取:
git pull --rebase origin main
若出现冲突,手动编辑冲突文件,移除标记(<<<<<<<, =======, >>>>>>>),保存后执行:
git add 冲突已解决的文件
git rebase --continue
解决后再执行 git push。
command not found,请手动输入命令。.gitignore,排除编译临时文件、IDE 配置等(如 node_modules/, *.log, .env)。git pull --rebase origin main 合并远程更改。git checkout -b feature/新功能名称
完成后切回主分支合并:
git checkout main
git merge feature/新功能名称 git branch -d feature/新功能名称
## 八、小结
1. 安装 Git 并配置 `user.name`、`user.email`。
2. 配置 SSH 密钥并添加到 GitHub。
3. 在 GitHub 创建空仓库(不初始化 README)。
4. 本地执行 `git init`,`git add .`,`git commit`。
5. 使用 `git remote add origin` 关联远程。
6. 执行 `git push -u origin main` 推送代码。
7. 后续更新遵循 `add` → `commit` → `push` 流程,合并前注意 `pull --rebase`。
以上步骤涵盖从环境搭建到代码同步的全流程,按步骤操作即可顺利维护 GitHub 仓库。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online