ProjectManagement on Leanku 的博客

Git项目多远程仓库同步方法

Sun, 18 May 2025 13:46:01 +0800

Git项目多远程仓库同步方法

同一个 Git 项目可以同时推送到多个远程仓库（如 Gogs 和 Gitee）。

1. 添加 Gitee 作为新的远程仓库

git remote add gitee <Gitee仓库的URL>

2. 验证远程仓库设置

1git remote -v

3. 推送到 Gitee

1git push gitee master # 推送 master 分支
2# 或推送所有分支：
3git push --all gitee

4.（可选）设置默认同时推送到两个仓库

修改 .git/config 文件，在 [remote “origin”] 部分添加多个 push URL：

[remote "origin"]
 url = https://gogs.example.com/yourname/yourrepo.git
 fetch = +refs/heads/*:refs/remotes/origin/*
 pushurl = https://gogs.example.com/yourname/yourrepo.git
 pushurl = https://gitee.com/yourname/yourrepo.git

这样 git push 会同时推送到两个仓库。

5. （可选）从 Gitee 拉取更新

1git pull gitee master

删除指定的远程仓库（如 gitee）

1git remote remove gitee

注意事项：

两个仓库的分支结构最好保持一致
如果两边都有新的提交，可能需要先合并再推送
大型项目首次推送到 Gitee 可能需要较长时间

这种方法可以让你保持代码在多个远程仓库同步，适用于需要备份或多平台协作的场景。

Git创建不继承内容的新分支

Sat, 10 May 2025 19:46:01 +0800

git filter-branch 清理误提交大文件

问题概述：

在当前项目中放有大文件（超过100M）package/grpc.tar.gz,进行了git add,commit 并push, push过程中出现了错误如：

remote: error: File package/grpc.tar.gz is 973.06 MB; this exceeds GitHub's file size limit of 100.00 MB

这个问题会导致后面的提交以及push出错

git filter-branch

用 git filter-branch 删除历史中所有的 grpc.tar.gz

git filter-branch --force --index-filter \
"git rm --cached --ignore-unmatch package/grpc.tar.gz" \
--prune-empty -- lite-AlmaLinux

💡 说明：这个命令会清理当前分支里所有 commit 中的 package/grpc.tar.gz

清理垃圾对象并压缩仓库大小

git reflog expire --expire=now --all
git gc --prune=now --aggressive

然后重新 push（第一次 push 分支）

git push --set-upstream origin lite-AlmaLinux

防止此类问题

优化 .gitignore，比如

# 忽略大文件
*.tar.gz

然后

git add .gitignore
git commit -m "update: ignore tar.gz files"
git push

GitHub 项目版本管理规范

Fri, 11 Apr 2025 20:46:01 +0800

GitHub 项目版本管理规范

Git 标签（Tags）和发布（Releases）在 GitHub 项目中定义和管理版本，通常结合 Git 标签（Tags）、发布（Releases）和语义化版本（SemVer）来实现。以下是具体方法和最佳实践：

1. 使用 Git 标签（Tags）定义版本

（1）创建版本标签

1# 创建轻量标签
2git tag v1.0.0
3
4# 创建附注标签（推荐，包含提交信息和签名）
5git tag -a v1.0.0 -m "Release version 1.0.0"
6
7# 推送标签到 GitHub
8git push origin v1.0.0

（2）语义化版本（SemVer）

版本号格式：MAJOR.MINOR.PATCH

MAJOR：不兼容的 API 变更
MINOR：向后兼容的功能新增
PATCH：向后兼容的问题修复

示例：

v1.0.0：初始稳定版本
v1.2.3：第 1 个大版本，第 2 次功能更新，第 3 次补丁

2. 通过 GitHub Releases 管理版本

（1）手动创建 Release

进入 GitHub 仓库 → Releases → Draft a new release

Git提交日志规范指南

Sun, 02 Apr 2023 21:46:01 +0800

在软件开发流程中，Git已经成为版本控制的事实标准。每次提交代码都需要填写commit message，否则不允许提交。然而，在日常开发中，我们经常会看到各种各样模糊不清的提交信息，如“fix bug”、“更新代码”、“修改问题”等。这些不规范的commit message充斥在git history中，导致后续维护人员无法快速定位问题，有时甚至连提交者自己都不记得某次提交的目的。因此，我们需要一套统一的规范来管理和约束commit message。

规范概述

目前业界最知名的规范是Angular团队的commit message规范，它结构清晰、易于实施，已被广泛应用于开源项目和商业项目中。同时，许多IDE（如IntelliJ IDEA）也提供了相应的插件（如Git Commit Template）来辅助开发者遵循这一规范。

本文将以Angular规范为基础，详细介绍一套通用的Git commit message规范，并提供具体的操作示例。

Commit Message整体结构

规范的commit message包含三个部分：Header、Body和Footer。其格式如下：

<header>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

重要说明：

Header是必需的，包含type、scope和summary三个子元素
Body是必需的，用于详细描述提交内容
Footer是可选的，用于记录不兼容变更或关闭issue

关键规则：Header和Body之间必须有一个空行分隔，这是许多Git工具正确解析提交信息的前提。

整体结构示例

feat(用户认证): 增加短信验证码登录功能

为了提升用户登录体验，增加了通过手机号接收验证码进行登录的方式。
- 集成阿里云短信服务
- 新增验证码生成与校验逻辑
- 更新登录页面UI

Closes #245

Header是commit message的“标题”，格式为：

<type>(<scope>): <summary>

其中，type和summary为必填项，scope为可选项。

Type：提交类别

Type用于说明本次提交的类别，必须使用以下标准化标识之一：

Type	说明	使用场景
`feat`	新功能	新增用户可见的功能特性
`fix`	修复bug	修复线上或测试环境发现的缺陷
`docs`	文档更新	仅修改文档，不涉及代码变更
`style`	代码格式	不影响代码运行的格式调整（空格、缩进、分号等）
`refactor`	代码重构	既不是新增功能，也不是修复bug的代码结构调整
`perf`	性能优化	提升系统性能或用户体验的代码变更
`test`	测试相关	新增或修改测试用例
`chore`	构建/工具变动	构建流程、依赖管理、辅助工具等变更
`revert`	回滚提交	撤销之前的某次提交

Type使用示例：

项目规范指南

Sat, 01 Apr 2023 21:46:01 +0800

项目规范指南

本规范适用于团队/开源项目的版本管理，目标是做到：规范化、可追踪、可溯源。

1. 版本管理 (Versioning)

遵循语义化版本规范 (Semantic Versioning, SemVer 2.0.0)
```
MAJOR.MINOR.PATCH
```
- MAJOR：主版本号，不兼容的 API 改动
- MINOR：次版本号，新增功能（向下兼容）
- PATCH：修订号，修复 bug（向下兼容）
先行版本号及版本编译信息可以加到“主版本号.次版本号.修订号”的后面，作为延伸。
预发布版本：1.0.0-alpha.1、2.0.0-rc.1

参考语义化版本规范：https://semver.org/lang/zh-CN/

2. LICENSE (MIT)

作用：MIT，明确版权

规范

项目必须包含 LICENSE 文件，放置于项目根目录。
推荐使用 MIT License（宽松、常用，几乎所有开源项目可接受）。
文件名统一：LICENSE（不要写成 LICENSE.txt 或 license.md）。
在 README.md 中需明确说明 License 类型。

示例

LICENSE 文件（MIT）：

1MIT License
2
3Copyright (c) 2025 Your Name
4
5Permission is hereby granted, free of charge, to any person obtaining a copy
6of this software and associated documentation files (the "Software"), to deal
7...

3. README.md

作用：项目介绍 + 使用 + License

Git创建不继承内容的新分支

Sun, 26 Feb 2023 19:46:01 +0800

Git创建不继承内容的新分支方法

在 Git 中，想创建一个新的分支，并且不想要当前分支的任何内容（即希望新分支是完全干净的，不包含当前分支的修改或提交），可以按照以下步骤操作：

方法 1：基于远程默认分支（如 main/master）创建新分支

如果你希望新分支是基于远程仓库的默认分支（而不是当前分支），可以这样做： ``` # 1. 确保本地没有未提交的修改（否则会提示你提交或暂存） git status

# 2. 拉取远程最新代码（确保本地默认分支是最新的）
git fetch origin

# 3. 基于远程默认分支（如 origin/main）创建新分支
git checkout -b 新分支名 origin/main

方法 2：基于某个提交或分支创建全新分支

如果你想基于某个特定的提交（而不是当前分支）创建新分支： ``` # 1. 先切换到目标分支或提交（例如切换到 main 分支） git checkout main

# 2. 拉取最新代码（可选）
git pull origin main

# 3. 创建并切换到新分支
git checkout -b 新分支名

方法 3：强制创建孤立分支（完全无历史）

如果你想创建一个完全独立的新分支（不继承任何历史）：

在切换分支之前，确保你没有未提交的修改，否则 Git 可能会尝试携带这些修改到新分支：

git status

# 提交他们
git add .
git commit -m "暂存当前修改"

# 或者丢弃它们
git reset --hard # 强制丢弃所有未提交的修改

创建一个完全独立的新分支（不继承任何历史）

Git历史重置

Sun, 26 Feb 2023 00:00:00 +0000

Git历史重置

有时候需要克隆github的项目使用，自己进行修改需要提交到自己的代码仓库，但是会包含前仓库的大量提交历史，看起来不方便，就需要清理历史记录并重置为一个全新的提交

新项目（如git clone 的项目）

 1# 进入项目目录
 2cd template-repo-master
 3# 删除原有的.git目录（如果存在）初始化全新的Git仓库
 4rm -rf .git
 5git init
 6
 7git add .
 8git commit -m "Initial commit from template"
 9
10git remote add origin git@github.com:your-username/your-new-repo.git
11
12git push -u origin master --force

已经将代码推送到自己的远程仓库清理历史记录并重置为一个全新的提交

 1# 1. 克隆你的远程仓库（可选）
 2git clone git@github.com:your-username/your-repo.git
 3cd your-repo
 4
 5# 2.创建孤立分支（全新的历史起点）
 6git checkout --orphan new-branch
 7
 8# 3. 添加所有文件到新分支
 9git add -A
10git commit -m "Initial commit (cleaned history)"
11
12#4. 删除旧的主分支
13git branch -D master # 或 main
14
15# 5. 重命名新分支为主分支
16git branch -m master # 或 main
17
18# 6. 强制推送到远程仓库
19git push -f origin master
20
21# 7. 更新远程仓库设置（如有必要）
22git branch --set-upstream-to=origin/master master
23
24# 检查提交历史应该只显示你的"Initial commit"
25git log --oneline

Git同时配置github和gitee

Sun, 26 Feb 2023 00:00:00 +0000

Git同时配置github和gitee

想要同时使用GitHub和Gitee，但是每次输入密码就会很麻烦。为此，本文将介绍 Git 同时配置 github和 gitee 的ssh key

1#查看git配置
2git config --global --list
3#没配置过的话先配置用户名和邮箱信息
4git config --global user.name “username”
5git config --global user.email “email”
6#默认没有.ssh目录，
7ssh-keygen -t rsa -C "xxxxxxx@xx.com"
8#在windows下会生成.ssh目录 [c盘/用户/用户名/.ssh]

1. 查看ssh文件

1cd ~/.ssh**  
2
3ls

2. 删除之前的.ssh

1 rm -rf id_rsa id_rsa.pub

3. 生成gitee和github 的 SSH Key

1ssh-keygen -t rsa -C "xxxxxxx@xx.com" -f "id_rsa_github"
2ssh-keygen -t rsa -C "xxxxxxx@xx.com" -f "id_rsa_gitee"

4. 查看SSH Key

1cat id_rsa_github.pub**

5. 拷贝 ssh-rsa 开头的 ssh key，然后到github上添加ssh key

6. 添加 config解决ssh冲突

 1vim config
 2
 3# 文件类容如下
 4# gitee
 5Host gitee.com
 6HostName gitee.com
 7PreferredAuthentications publickey
 8IdentityFile ~/.ssh/id_rsa_gitee
 9 
10# github
11Host github.com
12HostName github.com
13PreferredAuthentications publickey
14IdentityFile ~/.ssh/id_rsa_github

7. 测试是否配置成功

1ssh -T git@gitee.com 
2ssh -T git@github.com
3
4# 配置成功 正常会输出如下
5Hi leanku! You've successfully authenticated, but GitHub does not provide shell access.

8. 已经配置了 SSH 密钥，但在 git push 时仍然要求输入用户名和密码

检查远程 URL,如果显示 https://…，说明 Git 仍然在使用 HTTPS 方式。

Git版本升级

Fri, 21 Oct 2022 00:00:00 +0000

使用 Brew 对Mac系统Git进行版本升级

 1#安装最新的Git
 2➜ ~ brew install git
 3#改变默认Git指向
 4➜ ~ which git
 5#/usr/bin/git
 6➜ ~ git --version
 7#git version 2.24.1 (Apple Git-126)
 8➜ ~ brew link git --overwrite
 9#新开终端查看版本
10➜ ~ git version
11#git version 2.38.1

可以看到，我们的 git 版本已经升级到最新版了

ProjectManagement on Leanku 的博客

Git项目多远程仓库同步方法

Git项目多远程仓库同步方法

1. 添加 Gitee 作为新的远程仓库

2. 验证远程仓库设置

3. 推送到 Gitee

4.（可选）设置默认同时推送到两个仓库

5. （可选）从 Gitee 拉取更新

删除指定的远程仓库（如 gitee）

注意事项：

Git创建不继承内容的新分支

git filter-branch 清理误提交大文件

问题概述：

git filter-branch

防止此类问题

GitHub 项目版本管理规范

GitHub 项目版本管理规范

1. 使用 Git 标签（Tags）定义版本

（1）创建版本标签

（2）语义化版本（SemVer）

2. 通过 GitHub Releases 管理版本

（1）手动创建 Release

Git提交日志规范指南

规范概述

Commit Message整体结构

整体结构示例

Header详解

Type：提交类别

项目规范指南

项目规范指南

1. 版本管理 (Versioning)

2. LICENSE (MIT)

规范

示例

3. README.md

Git创建不继承内容的新分支

Git创建不继承内容的新分支方法

方法 1：基于远程默认分支（如 main/master）创建新分支

方法 2：基于某个提交或分支创建全新分支

方法 3：强制创建孤立分支（完全无历史）

Git历史重置

Git历史重置

新项目（如git clone 的项目）

已经将代码推送到自己的远程仓库 清理历史记录并重置为一个全新的提交

Git同时配置github和gitee

Git同时配置github和gitee

想要同时使用GitHub和Gitee，但是每次输入密码就会很麻烦。为此，本文将介绍 Git 同时配置 github和 gitee 的ssh key

1. 查看ssh文件

2. 删除之前的.ssh

3. 生成gitee和github 的 SSH Key

4. 查看SSH Key

5. 拷贝 ssh-rsa 开头的 ssh key，然后到github上添加ssh key

6. 添加 config解决ssh冲突

7. 测试是否配置成功

8. 已经配置了 SSH 密钥，但在 git push 时仍然要求输入用户名和密码

Git版本升级

已经将代码推送到自己的远程仓库清理历史记录并重置为一个全新的提交