GitHub 仓库上传、更新与维护指南

复制输出的字符串（以 ssh-ed25519 开头）。

2. 将 SSH 公钥添加到 GitHub

1. 登录 GitHub，点击右上角头像，选择 Settings。
2. 左侧栏找到 SSH and GPG keys，点击进入。
3. 点击 New SSH key，填写标题（如 'My Laptop'），粘贴公钥，点击 Add SSH key。
4. 测试连接：

   ssh -T [email protected]
   

   若提示 Hi <用户名>! You've successfully authenticated...，则配置成功。

四、创建远程仓库

1. 登录 GitHub，点击右上角 +，选择 New repository。
2. 填写仓库信息：
   • Repository name：项目名称（如 my-project）。
   • Description：可选描述。
   • Public/Private：根据需要选择公开或私有。
   • Initialize this repository with a README：不勾选，否则需先拉取再推送。
3. 点击 Create repository，复制页面上提供的 HTTPS 或 SSH 地址。

五、本地项目上传

假设本地项目路径为 ~/projects/my-project。

1. 初始化本地仓库

切换到项目目录：

cd ~/projects/my-project

执行初始化：

git init

2. 添加文件并提交

将所有文件加入暂存区：

git add .

提交更改：

git commit -m "首次提交：项目初始化"

若主分支名为 master，建议重命名为 main 以符合通用约定：

git branch -M main

3. 关联远程仓库

将远程地址添加为 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

4. 推送到远程

建立跟踪关系并推送：

git push -u origin main

若分支为 master，则使用 git push -u origin master。 推送成功后，刷新 GitHub 仓库页面即可查看文件。

六、后续开发与同步

1. 修改与上传

修改或新增文件后：

git add .
git commit -m "本次更新：简要说明修改内容"
git push

由于已建立跟踪关系，后续只需 git push。

2. 处理远程更新与冲突

多人协作时，远程可能有新提交。推送前先拉取：

git pull --rebase origin main

若出现冲突，手动编辑冲突文件，移除标记（<<<<<<<, =======, >>>>>>>），保存后执行：

git add 冲突已解决的文件
git rebase --continue

解决后再执行 git push。

七、常见问题与注意事项

1. 隐藏字符问题：复制命令前若有不可见字符（如破折号），会导致 command not found，请手动输入命令。
2. .gitignore 文件：在项目根目录创建 .gitignore，排除编译临时文件、IDE 配置等（如 node_modules/, *.log, .env）。
3. Token 安全：GitHub 已弃用 HTTPS 密码验证，需使用 Personal Access Token。
4. README 初始化冲突：若远程已初始化 README，直接推送会被拒绝。请先执行 git pull --rebase origin main 合并远程更改。
5. 分支管理：开发新功能建议新建分支：

   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 仓库。