Git

Git#

配置仓库#

典型工作流程#

工作目录 (Working Directory)：你正在编辑的文件。
暂存区 (Staging Area / Index)：通过 git add 添加的文件，准备下次提交。
版本库 (Repository / HEAD)：通过 git commit 提交后的历史记录。

# 列出所有已配置的远程仓库及其对应的 URL
git remote -v

# 显示所有远程跟踪分支
git branch -r

# 更新指定远程仓库的 URL 地址
git remote set-url <remote> <url>

# 显示工作目录和暂存区的状态 (变更文件列表)
git status

# 显示工作目录与暂存区之间的差异
git diff

# 显示两次特定提交之间的差异对比
git diff HEAD~1 HEAD~2

# 修改最近一次提交的提交信息 (不会创建新的提交)
git commit --amend -m "<message>"

# 基于当前提交创建新分支
git branch <branch>

# 重命名本地分支
git branch -m <old-name> <new-name>

# 安全删除已合并的本地分支
git branch -d <branch>

# 删除远程分支
git push origin --delete <branch>

# 显示当前分支的提交历史 (按时间倒序)
git log

# 逐行显示文件的修改历史 (作者、时间、提交信息)
git blame <filename>

# 将指定提交的更改应用到当前分支
git cherry-pick <commit>

# 将连续多个提交应用到当前分支 (包含首尾提交)
git cherry-pick <first-commit>^..<last-commit>

# 将指定提交合并到当前分支
git merge <commit>

# 将指定分支的所有更改合并到当前分支
git merge <branch>

# 将当前分支的提交在目标分支上重新应用 (变基操作)
git rebase <branch>

# 在当前提交上创建一个新标签
git tag <tag>

# 删除本地标签
git tag -d <tag>

# 将标签推送到远程仓库
git push <remote> <tag>

submodule#

代码提交规范#

类型	说明
`feat`	新功能
`fix`/`to`	修复漏洞
`docs`	文档
`style`	格式（不影响代码运行的变动）
`refactor`	重构（不改变功能的代码变动）
`perf`	优化相关，比如提升性能、体验
`test`	增加测试
`chore`	构建过程或辅助工具的变动
`revert`	回滚到上一个版本
`merge`	代码合并
`sync`	同步主线或分支的变动
`typo`	更改一些拼写错误

分支命名规范#

分支	命名	说明
主分支	`master`	主分支是提供给用户使用的正式版本
开发分支	`dev`	开发分支永远是功能最新最全的分支
功能分支	`feature-*`	新功能分支开发完成后需删除
发布版本	`release-*`	发布定期要上线的功能
发布版本修复分支	`bugfix-release-*`	修复测试 BUG
紧急修复分支	`bugfix-master-*`	紧急修复线上代码的 BUG

标签命名规范#

标签命名遵循 主版本号.次版本号.修订号 的规则，例如 v1.2.3 是版本 1.2 的第 4 次修订。以下是版本号的升级规则：

优化已经存在的功能，或者修复 BUG：修订号 +1；
新增功能：次版本号 +1；
架构变化，接口变更：主版本号 +1。

gitignore#

# 忽略特定文件
ModelIndex.xml
ExportedFiles.xml

# [] 匹配包含在 [] 范围内的任意字符
[Mm]odel/[Dd]eployment

# 使用 \ 加空格匹配包含空格的文件或文件夹
Program\ Files

# 忽略名为 hello 的目录和该目录下的所有文件，但是不会匹配名为 hello 的文件
hello/

# 忽略名为 hello 的文件
hello

# 忽略名为 b 的文件，该文件在文件夹 a 下，且该文件的路径为 a/b 或 a/任意路径/b
a/**/b

# 强制包含指定文件夹，* 匹配除了 / 之外任意数量的任意字符串
!Model/Portal/*/SupportFiles/[Bb]in/

# 强制包含指定文件，? 匹配除了 / 之外的任意一个字符
!Model/Portal/PortalTemplates/?/SupportFiles/[Bb]in

在 shell 中显示 git 分支#

Linux

方法一：使用 romkatv/gitstatus 提供的服务：

git clone --depth=1 https://github.com/romkatv/gitstatus.git ~/gitstatus
echo 'source ~/gitstatus/gitstatus.prompt.sh' >> ~/.bashrc

方法二：打开 ~/.bashrc 做如下修改：

# display git branch on bash
git_branch() {
branch="`git branch 2>/dev/null | grep "^\*" | sed -e "s/^\*\ //"`"
if [ "${branch}" != "" ];then
    if [ "${branch}" = "(no branch)" ];then
        branch="(`git rev-parse --short HEAD`...)"
    fi
    echo -e ":\033[01;32m$branch\033[00m"
fi
}

PS1 = '$(git_branch)' # 补充到 PS1 变量上

Windows

Post Git 提供了显示 Git 分支的功能，安装 Posh Git，请执行以下步骤：

以管理员身份启动 PowerShell。
修改执行策略以允许脚本运行：
```
Set-ExecutionPolicy RemoteSigned
```
安装 Posh Git 模块，指定范围为当前用户并强制安装：
```
Install-Module posh-git -Scope CurrentUser -Force
```
导入 Posh Git 模块以便使用：
```
Import-Module posh-git
```
将 Posh Git 添加到 PowerShell 配置文件中，以便对所有会话有效：
```
Add-PoshGitToProfile -AllHosts
```

卸载 Posh Git，请执行以下步骤：

以管理员身份运行 PowerShell。
删除 Posh Git 模块：
```
Uninstall-Module posh-git
```
编辑 PowerShell 配置文件以移除 Posh Git 模块的导入命令。打开配置文件：
```
notepad $PROFILE
```
然后，删除文件中包含 Import-Module posh-git 的行。

自动补全#