关联远程仓库

  • git remote add origin <远程仓库URL>
  • 例如：git remote add origin https://github.com/你的用户名/你的仓库名.git
  • 验证：git remote -v

首次推送分支

  • （将本地的 main 分支与远程的 origin/main 分支关联起来）[main/master]
  • git push -u origin main
  • 重命名分支名：git branch -M main

更新已关联的仓库

  • git add .(或指定文件)
  • git commit -m "描述你的修改"
  • git push

日志

  • git log --oneline --graph --all
  • 比本地多了什么：git log main..origin/main --oneline

修改地址

  • git remote set-url origin <正确的仓库URL>

删除重来

  • git remote remove origin
  • git remote add origin <正确的仓库URL>

改名

  • git remote add github <仓库URL>
  • git push -u github main

删除

  • git rm 文件名

  • git commit -m "删除不要的文件"

  • git push

  • 整个文件夹（含本地）： git rm -r 目录名

不再管理

  • git rm --cached 文件名

删除github上文件夹

  • git rm -r --cached 目录名
  • echo "文件名" >> .gitignore

（如果只是 git rm --cached 而不加 .gitignore，下次执行 git add . 时，这个文件又会被重新加入跟踪。）

  • git add .gitignore
  • git commit -m "chore: 停止跟踪 xxx 文件，本地保留"
  • git push

如果刚用 git rm 删了但还没 commit，想撤销：

  • git restore --staged 文件名 # 先从暂存区撤销删除记录
  • git restore 文件名 # 再恢复工作区文件

如果已经 commit 了，可以用 git checkout 从历史版本恢复：

  • git checkout HEAD~1 -- 文件名

解决冲突

  • 保留本地版本（HEAD）

git checkout --ours .gitignore

或者保留远程版本

git checkout --theirs .gitignore

git add .gitignore
git commit -m "merge: 解决 .gitignore 冲突"
git push

作为外部贡献者

  • 核心思路是：先复制一份到你自己的账号下，修改后再请求原作者合并。

  1. Fork（复刻）项目到你的账号

  2. lone（克隆）你的 Fork 到本地

    • git clone https://github.com/你的用户名/仓库名.git
    • cd 仓库名

  3. 关联上游仓库：git remote add upstream https://github.com/原作者/仓库名.git

  4. 创建独立分支:（永远不要直接在你的 main 分支上修改代码）

    • 先拉取上游最新代码
    • git fetch upstream
    • git merge upstream/main

  5. 创建并切换到你的功能分支（命名建议：fix/xxx, feature/xxx）

    • git checkout -b fix/your-bug-fix
    • 修改、提交并推送
    • git add .
    • git commit -m "fix: 清晰描述你的修改"
    • git push origin fix/your-bug-fix

  6. 发起 Pull Request (PR)

  7. 推送成功后，回到你 Fork 的 GitHub 页面，通常会自动出现一个 “Compare & pull request” 的绿色按钮。

1. 为个人仓库添加协作者（Collaborator）

2. 向 GitHub Organization 添加成员

作为团队成员

1 直接克隆原始仓库

  • git clone https://github.com/原作者/仓库名.git
  • cd 仓库名

2 创建分支、修改并推送

  • git checkout -b feature/your-feature-name
部分含义
git checkout切换分支（或恢复文件）的命令
-b branch表示“新建一个分支”
feature/your-feature-name新分支的名字，这里是一个示例
  • ... 修改代码 ...
  • git add .
  • git commit -m "feat: 描述你的新功能"
  • git push origin feature/your-feature-name

3 发起 Pull Request（推荐）或直接合并

为个人仓库添加协作者（Collaborator）

  1. 进入仓库设置：在 GitHub 上打开你的仓库页面，点击顶部的 “Settings”（设置） 选项卡。

  2. 找到管理访问权限的位置：在左侧边栏的“Access”部分，点击 “Collaborators”（个人仓库）或 “Collaborators & teams”。

  3. 发起邀请：点击 “Add people”（添加人员）或“Invite a collaborator”按钮。

  4. 搜索并选择用户：输入对方的 GitHub 用户名或邮箱地址，并从搜索结果中选中正确的人。

  5. 设定权限并发送：为该用户选择一个角色（Role），然后点击“Add”或“Send invitation”发送邀请。

  6. 对方需要接受邀请：邀请发出后，对方会收到一封邮件和站内通知。必须由对方手动接受邀请后，访问权限才会正式生效。