从零开始使用 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