ELMEC DOCS

Theme

GitHub 仓库管理完全指南 ​

wanglinqiang 2026年4月25日

本指南涵盖了从安装配置到高级仓库重置的核心操作流程。

环境安装与配置 ​

安装 Git ​

  • Windows: 前往 git-scm.com 下载并安装。
  • macOS: 终端输入 brew install git 或安装 Xcode Command Line Tools。
  • Linux: 使用包管理器，如 sudo apt install git。

全局身份配置 ​

安装后，首先配置你的用户名和邮箱（用于记录提交者身份）：

shell
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"

配置 SSH 密钥（推荐） ​

为了避免每次推送都输入密码，建议配置 SSH：

  1. 生成密钥：ssh-keygen -t ed25519 -C "your_email@example.com"。
  2. 复制公钥内容：cat ~/.ssh/id_ed25519.pub。
  3. 进入 GitHub [Settings -> SSH and GPG keys] 添加该公钥。

GitHub 创建仓库 ​

  1. 登录 GitHub，点击右上角 + -> New repository。
  2. 填写 Repository name（仓库名）。
  3. 选择 Public 或 Private。
  4. 注意：如果打算推送本地已有代码，请不要勾选 "Initialize this repository with a README"。

初次提交与关联 ​

在本地项目根目录下打开终端：

shell
# 1. 初始化本地仓库
git init

# 2. 将所有文件添加到暂存区
git add .

# 3. 提交到本地版本库
git commit -m "feat: 初次提交项目代码"

# 4. 建立主分支 (GitHub 现在默认使用 main)
git branch -M main

# 5. 关联远程仓库 (请替换为你自己的 SSH 或 HTTPS 地址)
git remote add origin git@github.com:用户名/仓库名.git

# 6. 推送到远程仓库（-u 参数会建立跟踪关系，下次只需 git push）
git push -u origin main

日常开发与同步 ​

提交修改 ​

shell
git status               # 查看当前修改状态
git add .                # 添加所有修改
git commit -m "fix: 修复了XX功能"
git push                 # 推送到远程

获取更新 ​

如果远程仓库有变动（如在网页端编辑了文件），需先拉取：

shell
git pull origin main

重置提交历史（清爽模式） ​

如果你希望删除之前所有的混乱提交记录，将当前状态作为唯一的起点的“瘦身”操作：

shell
# 1. 创建并切换到一个全新的“孤立”分支
git checkout --orphan temp_branch

# 2. 暂存所有文件
git add -A

# 3. 提交
git commit -m "chore: 重置所有提交历史为初始状态"

# 4. 删除本地旧的 main 分支
git branch -D main

# 5. 将当前临时分支重命名为 main
git branch -m main

# 6. 强制推送到 GitHub（覆盖远程历史）
# 警告：这会删除 GitHub 上该分支的所有旧记录，团队协作时请谨慎使用
git push -f origin main

实用小贴士💡 ​

忽略不需要文件 (.gitignore) ​

在项目根目录创建一个 .gitignore 文件，写下不需要追踪的文件夹或文件，防止它们占用空间。如:

md
node_modules/
.env/
dist/

6.2 常用状态查看 ​

shell
# 查看简洁的提交历史
git log --oneline			
# 查看当前关联的远程仓库地址
git remote -v					
# 查看文件具体修改了哪些内容
git diff

撤销操作 ​

  • 撤销 add: git reset .
  • 修改最后一次 commit 信息: git commit --amend

ELMEC Document Center

Copyright © 2026