Heck's Blog

# 你的默认全局账号
[user]
  name = heck
  email = i@heckjj.com

# ======================
# 自动切换 heckjj 账号
# ======================
[includeIf "hasconfig:remote.*.url:https://git.tencent.com/**"]
  path = .gitconfig-tencent

最后一步：必须新建这个文件
打开文件夹：C:\Users\你的用户名\
新建一个文件，名字叫：
.gitconfig-tencent
内容只有这两行：
[user]
  name = heck
  email = heck@tencent.com

这样就自动生效了
所有 git.tencent.com 仓库 → 自动用 heck
其他所有仓库 → 用你的默认账号 heck
不用手动切换，不用每个仓库单独设置

`git feat` 是指在 Git 提交（commit）信息中使用 `feat` 作为前缀，它是英文 “feature”（新功能）的缩写，用于标识本次提交新增了一个功能或特性。

这一用法源于 [Conventional Commits（约定式提交）](https://www.conventionalcommits.org/) 规范，该规范通过标准化提交信息格式，提升团队协作效率，并便于自动生成变更日志（changelog）和版本号管理。

---

常见提交类型前缀含义

- `feat`：新增功能（feature）  
  示例：`feat: 添加用户登录功能`
- `fix`：修复 bug  
  示例：`fix: 修复登录超时问题`
- `docs`：仅修改文档  
  示例：`docs: 更新 README 使用说明`
- `style`：代码样式调整（不影响运行）  
  示例：`style: 格式化代码缩进`
- `refactor`：代码重构（非新增功能、非修复 bug）  
  示例：`refactor: 提取用户验证逻辑为独立函数`
- `chore`：构建过程或工具依赖更新  
  示例：`chore: 更新 npm 依赖包`
- `test`：增加或修改测试  
  示例：`test: 添加登录接口单元测试`

---

提交信息结构（Conventional Commits）

标准格式为：

```
():
[body]
[footer]
```

- `type`：必须，如 `feat`、`fix` 等  
- `scope`：可选，限定影响范围，如 `(auth)`、`(api)`  
- `subject`：简短描述（≤50 字符）  
- `body` / `footer`：可选，详细说明或关联 issue

示例完整写法：

```bash
feat(auth): 添加 Google OAuth 登录支持

- 允许用户通过 Google 账号一键登录
- 集成 OAuth2.0 流程
- 关联 JIRA-123
```

---

实践意义

- ✅ 提高可读性：团队成员快速理解提交目的  
- ✅ 支持自动化：工具（如 `semantic-release`）可依据 `feat` 自动升级版本号  
- ✅ 便于生成 changelog：按类型分类生成发布说明  

更多规范细节可参考：[Conventional Commits 官方规范](https://www.conventionalcommits.org/)

本文档定义了团队使用 Git 的标准流程和规范，所有团队成员必须遵循。

版本：v1.0.0
最后更新：2026年
适用范围：所有项目

目录
分支管理规范
提交信息规范
工作流程规范
代码审查规范
命名规范
安全规范
工具与配置
常见场景处理
1. 分支管理规范
1.1 分支类型
主分支（Main Branches）
main / master

用途：生产环境代码
保护：✅ 必须通过 Pull Request 合并
禁止：❌ 禁止直接推送，禁止强制推送
develop

用途：开发环境代码，日常开发集成
保护：✅ 必须通过 Pull Request 合并
禁止：❌ 禁止直接推送
辅助分支（Supporting Branches）
feature/* - 功能开发分支

命名：feature/功能名称，如 feature/user-login
来源：从 develop 创建
目标：合并回 develop
生命周期：功能完成后删除
fix/* - Bug 修复分支

命名：fix/问题描述，如 fix/login-button-bug
来源：从 develop 创建
目标：合并回 develop
生命周期：修复完成后删除
hotfix/* - 紧急修复分支

命名：hotfix/紧急修复描述，如 hotfix/security-patch
来源：从 main 创建
目标：合并回 main 和 develop
生命周期：修复完成后删除
release/* - 发布准备分支

命名：release/版本号，如 release/1.0.0
来源：从 develop 创建
目标：合并回 main 和 develop
生命周期：发布完成后删除
1.2 分支命名规则
✅ 允许的命名：

使用小写字母
使用连字符 - 分隔单词
简洁但描述性
示例：feature/user-authentication、fix/payment-error
❌ 禁止的命名：

使用大写字母
使用下划线或空格
使用个人名称
使用特殊字符
示例：Feature/Login、fix_bug、zhangsan-feature
1.3 分支保护规则
main 分支保护
✅ 必须通过 Pull Request 合并
✅ 至少 1 位团队成员审查通过
✅ 必须通过所有 CI/CD 检查
✅ 禁止直接推送
✅ 禁止强制推送
✅ 禁止删除分支
develop 分支保护
✅ 必须通过 Pull Request 合并
✅ 至少 1 位团队成员审查通过
✅ 必须通过所有 CI/CD 检查
✅ 禁止直接推送
✅ 禁止强制推送
2. 提交信息规范
2.1 提交信息格式
<类型>(<范围>): <简短描述>

<详细描述（可选）>

<相关 Issue（可选）>

一、什么是Git分支管理？
Git分支管理是指在Git版本控制系统中，通过创建和管理多个分支来组织代码开发流程，支持并行开发、代码隔离和版本控制。
简单说，就像一棵树的主干和分支，master分支是主干，feature分支是枝叶，每个分支都可以独立生长，最后再合并到主干。
其核心作用包括：
  
• 并行开发：多个功能可以同时开发而不相互干扰。
  
• 代码隔离：开发分支、测试分支、生产分支相互隔离。
  
• 版本管理：支持版本回退、热修复和发布管理。
  
• 团队协作：多人协作时减少代码冲突。
  
二、分支类型说明
2.1 长期存在分支（核心基础分支）
master 主分支
  
• 定位：生产环境分支，存放已发布的稳定、可靠版本代码。
  
• 核心规则：仅用于发布新版本，禁止直接修改或提交新功能。
  
develop 开发分支
  
• 定位：日常开发主分支，汇总当前所有正在推进的功能和任务。
  
• 核心规则：所有新功能开发、改进、优化均从该分支发起，完成后最终合并回此分支。
  
2.2 临时创建分支（辅助开发/发布分支，完成后删除）
feature 功能分支
  
• 创建来源：从 develop 分支创建，功能分支的名字，可以采用feature-*的形式命名
  
• 用途：单独开发某一个新功能（一个功能对应一个分支）
  
• 流转终点：功能实现、测试完成后，合并回 develop 分支
  
release 发布分支（不一定用）
  
• 创建来源：从 develop 分支创建
  
• 用途：为即将发布的版本做最终准备，仅开展测试、bug修复、文档检查等工作（不新增功能）
  
• 流转终点：准备完成且测试通过后，同时合并回 master 分支（作为新发布版本）和 develop 分支（同步发布前的修复内容）
  
hotfix 紧急修复分支
  
• 创建来源：从 master 分支创建
  
• 用途：紧急修复生产环境（master 分支对应版本）中出现的问题
  
• 流转终点：修复完成后，同时合并回 master 分支（更新生产版本）和 develop 分支（同步修复内容，避免后续版本复现问题）

错误原因和现象
在执行shell脚本的时候，报错：/bin/bash^M: bad interpreter: No such file or directory。
是由于该脚本文件是在Windows平台编写，然后在MacOS或者Kylin-Server平台中执行。
在Windows平台上文件是dos格式，换行符尾\r\n，而MacOS或者Kylin-Server平台文件是unix格式，换行符尾\n。因此在运行脚本文件时，不能正确解析\r，导致编译错误、运行失败。

解决方案

在MacOS或者Kylin-Server平台上，打开命令行工具执行命令vim *.sh（编辑你的脚本文件），然后执行命令:set ff=unix，最后执行:wq( 保存退出)即可。

linux同步时间命令：

1、hwclock命令，可以让系统时间和硬件时间的同步，例“hwclock -w”或“hwclock -s”；
2、ntpdate命令，可以让不同机器间同步时间。


在Windwos中，系统时间的设置很简单，界面操作，通俗易懂，而且设置后，重启，关机都没关系。系统时间会自动保存在BIOS时钟里面，启动计算机的时候，系统会自动在BIOS里面取硬件时间，以保证时间的不间断。

但在Linux下，默认情况下，系统时间和硬件时间并不会自动同步。在Linux运行过程中，系统时间和硬件时间以异步的方式运行，互不干扰。硬件时间的运行，是靠BIOS电池来维持，而系统时间，是用CPU Tick来维持的。在系统开机的时候，会自动从BIOS中取得硬件时间，设置为系统时间。

1. Linux系统时间的设置
在Linux中设置系统时间，可以用date命令：

//查看时间

[root@node1 ~]# date

Tue Feb 25 20:15:18 CST 2014

//修改时间

[root@node1 ~]# date -s "20140225 20:16:00"  #yyyymmdd hh:mm:ss

Tue Feb 25 20:16:00 CST 2014

//date 有多种时间格式可接受，查看date --help

2. Linux硬件时间的设置
硬件时间的设置，可以用hwclock或者clock命令。两者基本相同，只用一个就行，只不过clock命令除了支持x86硬件体系外，还支持Alpha硬件体系。

//查看硬件时间可以是用hwclock ，hwclock --show 或者 hwclock -r

[root@node1 ~]# hwclock --show

Tue 25 Feb 2014 08:21:14 PM CST -0.327068 seconds

//设置硬件时间

[root@node1 ~]# hwclock --set --date "20140225 20:23:00"

[root@node1 ~]# hwclock

Tue 25 Feb 2014 08:23:04 PM CST -0.750440 seconds

3. 系统时间和硬件时间的同步
同步系统时间和硬件时间，可以使用hwclock命令。

//以系统时间为基准，修改硬件时间

[root@node1 ~]# hwclock --systohc <== sys（系统时间）to（写到）hc（Hard Clock）

//或者

[root@node1 ~]# hwclock -w

//以硬件时间为基准，修改系统时间

[root@node1 ~]# hwclock --hctosys

//或者

[root@node1 ~]# hwclock -s

MinIO 服务器配置文件（config.json）存储在 --config-dir 指定的配置目录中，--config-dir 默认值为 ${HOME}/.minio（笔者的目录为 C:\Users\Administrator\.minio）。

但是从 RELEASE.2018-08-18T03-49-57Z 之后的版本开始，配置文件已迁移到存储数据的 .minio.sys/config 目录（存储后端是启动服务器时传递给 MinIO 服务器的目录）。如果使用如下命令启动 MinIO 服务：


minio.exe server D:/tmp/data
则配置文件位于 D:\tmp\data\.minio.sys\config 目录中。

注意：你可以使用 mc -h 命令查看当前 MinIO 的版本信息，如下：


D:\server\minio>mc -h
NAME:
  mc - MinIO Client for cloud storage and filesystems.
...
VERSION:
  RELEASE.2021-06-13T17-48-22Z
您可以使用 --config-dir 指定现有配置的位置，MinIO 会自动将 config.json 迁移到您的后端存储。您当前 --config-dir 指定的 config.json 配置文件将在成功迁移后重命名为 config.json.deprecated。

如果你的配置文件位于 C:\Users\Administrator\.minio\config.json，MinIO 会自动将 config.json 中的配置迁移到 D:\tmp\data\.minio.sys\config\config.json 文件，然后将 C:\Users\Administrator\.minio\config.json 重命名为 C:\Users\Administrator\.minio\config.json.deprecated。

此外 --config-dir 现在是一个遗留选项，计划在将来删除，因此请相应地更新您的本地启动和 ansible 脚本。使用如下命令去启动 MinIO 服务：

minio.exe server D:\tmp\data
上面命令，将创建的存储桶以及存储桶中的对象放到 D:\tmp\data 目录，并且配置信息均位于 D:\tmp\data\.minio.sys 目录。

第一步，进入/opt 目录，创建minio文件夹
cd /opt
mkdir minio
第二步，wget下载安装包：
https://dl.minio.io/server/minio/release/linux-amd64/minio

第三步，进入minio文件夹创建log文件
cd /minio
touch minio.log


第四步，赋予minio文件执行权限

chmod 777 minio
第五步，启动minio
./minio server /opt/minio/data （/opt/minio/data 为你存放静态文件的目录）


这个时候我们看下面爆红的提示，说的是：
警告：控制台端点正在侦听动态端口 (39175)，请使用 --console-address “:PORT” 选择静态端口。
警告：检测到默认凭据“minioadmin:minioadmin”，我们建议您使用“MINIO_ROOT_USER”和“MINIO_ROOT_PASSWORD”环境变量更改这些值

所以我们按照提示来：


export MINIO_ROOT_USER=fileadmin
export MINIO_ROOT_PASSWORD=fileadmin
第六步，重新启动minio
./minio server /opt/minio/data （/opt/minio/data 为你存放静态文件的目录）
第七步，设置环境变量
vim /etc/profile
添加

# set minio environment
export MINIO_ROOT_USER=fileadmin
export MINIO_ROOT_PASSWORD=fileadmin
生效：source /etc/profile;

第 七步，设置minio后台启动（指定端口）
vim start.sh

nohup /opt/minio/minio server  /opt/minio/data --console-address ":35555" > /opt/minio/minio.log 2>&1 &
('2>&1’表示现在标准输出直接输入到/opt/minio/minio.log 中，而2>&1是将标准错误重定向到标准输出,‘nohup’和末尾’&'组合使用表示脱离终端后继续执行)

让bat批处理以管理员权限运行的实现方法
有的电脑是非管理员登录，运行程序时，需要提示是否运行运行。解决方法如下：
在批处理开头加上：
适用于无参数

%1 mshta vbscript:CreateObject("Shell.Application").ShellExecute("cmd.exe","/c "^&chr(34)^&"%~0"^&chr(34)^&" ::","%cd%","runas",1)(window.close)&&exit

适用于有参数

%2 mshta vbscript:CreateObject("Shell.Application").ShellExecute("cmd.exe","/c "^&chr(34)^&"%~0"^&chr(34)^&" "^&chr(34)^&"%~1"^&chr(34)^&" ::","%cd%","runas",1)(window.close)&&exit

更多参数的以此类推
运行批处理时多加一个参数::，这句就不会执行
为了兼容8.3短路径，可把%~0等换成%~s0等
理论上是没问题，但启动路径有时不可靠，之后可能还要pushd或cd /d

bat文件以管理员权限运行的几种方式

1、创建bat快捷方式，然后右键快捷方式-->properties-->advanced-->Run as administrator。
2、下载bat转成exe工具，将bat转成exe,然后右键exe-->properties-->Compatibility-->Run as administrator。
3、以管理员权限运行cmd，然后dos框中运行相应的bat。

想更改hosts文件添加域名与地址ip、由于hosts文件受保护并且是只读属性。因此需要先赋予权限，并取消只读属性才能正常写入
   /E            编辑 ACL 而不替换。
   /G 　　　赋予指定用户访问权限。
   F 　　　完全权限。

Administrators、SYSTEM、Users（是windows用户组需要什么加什么）

attrib 是控制文件属性的

　　+ 添加文件属性

        -  删除文件属性

        R 只读文件属性

        A 存档文件属性

        S 系统文件属性

        H 隐藏文件属性

         I 无连接属性

@echo
@echo 127.0.0.1 .heckjj.com >>E:hosts（这是我们要写入的内容）

虽然脚本比较笨拙，但是亲测有效，若是找不到好的方法可以选择试一下O(∩_∩)O
======================================================================================
1、新建记事本输入一下内容
bat脚本代码如下：

set HOSTS=C:\Windows\System32\drivers\etc\hosts
echo Y|cacls %HOSTS% /E /G Administrators:F
echo Y|cacls %HOSTS% /E /G SYSTEM:F
echo Y|cacls %HOSTS% /E /G Users:F

attrib -r -h %HOSTS%

@echo
@echo.>>%HOSTS%


@echo 127.0.0.1 heckjj.com >>%HOSTS%

attrib +r +h %HOSTS%

title 刷新本地dns缓存并退出
echo 查看修改后的hosts文件内容,1秒后退出!
type "%HOSTS%" |findstr /v "^#"|findstr "[0-9]"
ping -n 1 127.0.0.1>nul
ipconfig /flushdns
echo 刷新本地缓存成功，即将退出!
ping -n 2 127.0.0.1>nul
echo.
exit
2、将记事本后缀名改为.bat格式的文件，然后双击即可完成修改。