Git on Liangweidong's blog

自托管 Git 平台镜像实战：Gitea / Gitblit / Gogs 部署与提交前代码规范检查

Wed, 15 Jun 2022 00:00:00 +0800

不是所有公司都需要"重型"的 GitLab EE。10 人以下小团队、单仓库 / 单分支、偶尔需要自托管——这种场景下，Gitea、Gitblit、Gogs 三款轻量自托管 Git 服务更合适：镜像小、启动快、吃内存少（一个 Gitea 跑 200 MB 内存，GitLab 起步就是 4 GB）。

但自托管 Git 平台只是入口——真正让团队"省心"的是把代码规范检查内置到提交链路里：客户端 pre-commit 钩子挡住本地漏改的代码，服务端 pre-receive 钩子挡住别人 PR 漏改的代码。

阅读对象：需要从零搭自托管 Git 服务的小团队 leader，或想给现有 Gitea 加代码规范检查的开发者
覆盖范围：Gitea / Gitblit / Gogs 三款服务的镜像部署、对比、客户端 p3c-pmd pre-commit 检查、服务端 pre-receive 钩子、黑白名单机制

一、三款 Git 平台对比

维度	Gitea	Gitblit	Gogs
语言	Go	Java	Go
镜像大小	~50 MB	~150 MB	~30 MB
内存占用	200 MB~	500 MB~	200 MB~
启动时间	秒级	30 秒	秒级
维护活跃度	极高（社区驱动，月级发版）	低（停更风险）	中（社区维护）
镜像选择	`gitea/gitea` 官方	`gitblit/gitblit` 第三方	`gogs/gogs` 官方
Web UI	现代（仿 GitHub）	复古（类似 Bitbucket）	简洁（仿 GitHub）
权限模型	完善（团队/组织/仓库级）	中等	基础
CI/CD 内置	有（Gitea Actions）	无	无
包管理（Packages）	有	无	无
迁移工具	一键从 GitHub/GitLab/Gogs 导入	导入脚本	一键从 GitHub 导入

When to use：

新项目 / 长期维护 → Gitea（社区活跃、UI 现代、CI 内置）

老牌 Java 团队 / 不想装 Go 运行时 → Gitblit（纯 Java 部署）

极致轻量 / 资源紧张 → Gogs（镜像最小、维护尚可）

二、Gitea 部署（推荐）

2.1 镜像选择

镜像	用途
`gitea/gitea:latest`	最新版（开发版，不推荐生产）
`gitea/gitea:1.19`	1.19 系列（推荐 LTS）
`gitea/gitea:1.23-jdk8`	1.23 + JDK8（给需要跑 java 工具的钩子用）

2.2 docker run 启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


docker run -d \
 --name gitea \
 --privileged=true \
 --restart=always \
 -e TZ=Asia/Shanghai \
 -e USER_UID=1000 \
 -e USER_GID=1000 \
 -p 13000:3000 \
 -p 10022:22 \
 -v /d/release/gitea:/data \
 gitea/gitea:1.19.0-rc1

坑 1：--privileged=true 是为了让钩子脚本能正常运行（pre-receive 等钩子会涉及 chown、chmod）。不用 --privileged 会导致钩子"无法执行"。

2.3 docker-compose 启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# docker-compose.yml
version: "3"
services:
 gitea:
 image: gitea/gitea:1.23.5-jdk8
 container_name: gitea
 restart: always
 privileged: true
 environment:
 - TZ=Asia/Shanghai
 - USER_UID=1000
 - USER_GID=1000
 ports:
 - "13000:3000" # Web
 - "10022:22" # SSH
 volumes:
 - "/home/docker/gitea/data:/data"

坑 2：gitea/gitea:1.23.5-jdk8 的 -jdk8 后缀是给"需要在 Gitea 容器内跑 Java 工具"（如 p3c-pmd）的场景用的。如果你的代码规范检查不在 Gitea 容器内跑，用普通 gitea/gitea:1.23 镜像更小。

2.4 关键配置

容器内 /data/gitea/conf/app.ini：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


[server]
DOMAIN = <YOUR_DOMAIN>
SSH_DOMAIN = <YOUR_DOMAIN>
HTTP_PORT = 3000
ROOT_URL = http://<YOUR_DOMAIN>:13000/

[security]
INTERNAL_TOKEN = <RANDOM_32_BYTES>

[service]
DISABLE_REGISTRATION = false
ENABLE_NOTIFY_MAIL = false

[migrations]
ALLOWED_DOMAINS = 127.0.0.1,<INTERNAL_HOST>,<PUBLIC_HOST>,gitee.com
ALLOW_LOCALNETWORKS = true

[oauth2]
ENABLED = true

坑 3：ALLOWED_DOMAINS + ALLOW_LOCALNETWORKS=true 是让 Gitea 能从内网 IP 拉代码（clone 公共仓库），不配这个导入外部仓库会报 403。

2.5 创建第一个仓库

Web 端：登录 → + → 创建新仓库

命令行：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 从命令行创建新仓库
mkdir myproject && cd myproject
git init
git checkout -b main
echo "# My Project" > README.md
git add .
git commit -m "first commit"
git remote add origin ssh://git@<GITEA_HOST>:10022/<USERNAME>/myproject.git
git push -u origin main

# 推送已存在的仓库
cd existing-project
git remote add origin ssh://git@<GITEA_HOST>:10022/<USERNAME>/existing-project.git
git push -u origin main

2.6 升级路径

gitea:jdk8 → gitea:1.23.5-jdk8 这种升级数据完全兼容——直接换镜像 tag 即可：

1
2
3
4


docker-compose down
# 改 docker-compose.yml 的 image tag
docker-compose up -d
# 启动后会自动跑数据库 migration

三、Gitblit 部署

Gitblit 的特点是纯 Java——如果你公司强制 Java 技术栈、或不想在服务器装 Go 运行时，选它。

1
2
3
4
5


# 第三方镜像（Gitblit 官方未提供 Docker 镜像）
docker pull jacekkowalski/gitblit
docker run -d -p 8080:8080 -p 8443:8443 \
 -v /data/gitblit:/opt/gitblit-data \
 jacekkowalski/gitblit

访问 http://<HOST>:8080/，默认账号 admin/admin（首次登录后改密）。

坑 4：Gitblit 镜像社区维护，版本和官方 release 可能有滞后；建议自己 build：

1
2
3
4
5
6


FROM openjdk:8-jre
RUN wget https://github.com/gitblit/gitblit/releases/download/v1.9.3/gitblit-1.9.3.tar.gz && \
 tar -xzf gitblit-1.9.3.tar.gz -C /opt && \
 rm gitblit-1.9.3.tar.gz
EXPOSE 8080 8443
CMD ["/opt/gitblit-1.9.3/gitblit.sh"]

四、Gogs 部署

Gogs 是 Gitea 的"前辈"——Gitea 团队最初就是从 Gogs fork 出来的（2016 年 fork 原因是"想更积极地迭代"）。

1
2
3
4
5
6
7


docker run -d \
 --name gogs \
 --restart=always \
 -p 13000:3000 \
 -p 10022:22 \
 -v /data/gogs:/data \
 gogs/gogs:0.13

坑 5：Gogs 0.13 是最后的稳定版，2020 年后社区基本被 Gitea 吸引。新项目不建议选 Gogs——除非你正在维护一个老 Gogs 实例（数据迁移到 Gitea 是免费的）。

五、客户端提交前检查：p3c-pmd

“我自己在本地忘了跑规范检查”——这是最常见的"提交违规"原因。解决：把规范检查做成 git pre-commit 钩子，每次 git commit 自动跑。

5.1 准备 p3c-pmd 工具

1
2
3
4
5


# 1. 下载 p3c-pmd 项目
git clone https://github.com/alibaba/p3c.git
cd p3c/p3c-pmd
mvn clean package
# 产出: p3c-pmd-2.1.1-jar-with-dependencies.jar

坑 6：必须用 p3c-pmd，不要用 pmd-dist——p3c-pmd 是阿里《Java 开发手册》对应的 PMD 规则集（命名规范、注释规范、OOP 规约、集合处理、并发处理等）。

5.2 手动跑一次（验证工具）

1
2
3
4


java -cp p3c-pmd-2.1.1-jar-with-dependencies.jar net.sourceforge.pmd.PMD \
 -d <PROJECT_DIR> \
 -R rulesets/java/ali-comment.xml,rulesets/java/ali-concurrent.xml,rulesets/java/ali-constant.xml,rulesets/java/ali-exception.xml,rulesets/java/ali-flowcontrol.xml,rulesets/java/ali-naming.xml,rulesets/java/ali-oop.xml,rulesets/java/ali-orm.xml,rulesets/java/ali-other.xml,rulesets/java/ali-set.xml \
 -f text -shortnames -no-cache -min 1

输出形如：

1
2


/home/user/project/src/main/java/com/example/Foo.java:42: Avoid start with number for class name...
/home/user/project/src/main/java/com/example/Bar.java:88: Method name should be lowerCamelCase...

5.3 Maven 集成（开发期自动跑）

pom.xml 加：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75


<properties>
 <maven-pmd-plugin.version>3.21.2</maven-pmd-plugin.version>
 <p3c-pmd.version>2.1.1</p3c-pmd.version>
</properties>
<build>
 <plugins>
 <plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-pmd-plugin</artifactId>
 <version>${maven-pmd-plugin.version}</version>
 <configuration>
 <verbose>true</verbose>
 <rulesets>
 <ruleset>/rulesets/java/ali-comment.xml</ruleset>
 <ruleset>/rulesets/java/ali-concurrent.xml</ruleset>
 <ruleset>/rulesets/java/ali-constant.xml</ruleset>
 <ruleset>/rulesets/java/ali-exception.xml</ruleset>
 <ruleset>/rulesets/java/ali-flowcontrol.xml</ruleset>
 <ruleset>/rulesets/java/ali-naming.xml</ruleset>
 <ruleset>/rulesets/java/ali-oop.xml</ruleset>
 <ruleset>/rulesets/java/ali-orm.xml</ruleset>
 <ruleset>/rulesets/java/ali-other.xml</ruleset>
 <ruleset>/rulesets/java/ali-set.xml</ruleset>
 </rulesets>
 <printFailingErrors>true</printFailingErrors>
 <minimumPriority>1</minimumPriority>
 </configuration>
 <executions>
 <execution>
 <id>pmd-check-verify</id>
 <phase>package</phase>
 <goals>
 <goal>check</goal>
 </goals>
 </execution>
 <execution>
 <id>pmd-pmd-site</id>
 <phase>site</phase>
 <goals>
 <goal>cpd</goal>
 </goals>
 </execution>
 </executions>
 <dependencies>
 <dependency>
 <groupId>com.alibaba.p3c</groupId>
 <artifactId>p3c-pmd</artifactId>
 <version>${p3c-pmd.version}</version>
 </dependency>
 </dependencies>
 </plugin>

 <!-- 自动安装 git pre-commit 钩子 -->
 <plugin>
 <groupId>io.github.phillipuniverse</groupId>
 <artifactId>githook-maven-plugin</artifactId>
 <version>1.0.5</version>
 <executions>
 <execution>
 <goals>
 <goal>install</goal>
 </goals>
 <configuration>
 <hooks>
 <pre-commit>
 echo running validation build
 exec mvn clean package -DskipTests
 </pre-commit>
 </hooks>
 </configuration>
 </execution>
 </executions>
 </plugin>
 </plugins>
</build>

第一次 mvn package 时，githook-maven-plugin 会自动把 pre-commit 钩子装到 .git/hooks/pre-commit。之后每次 git commit 都会先跑 mvn clean package，失败就阻止 commit。

坑 7：minimumPriority=1 是 PMD 规则的"最高优先级"——只有"严重"问题会被拦下来。如果设为 5，所有问题都拦，开发体验会很差。建议从 1 起步，逐步放开到 2 / 3。

5.4 手动安装 pre-commit 钩子（不依赖 Maven）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
echo "[pre-commit] running p3c-pmd check"
java -cp /path/to/p3c-pmd-2.1.1-jar-with-dependencies.jar net.sourceforge.pmd.PMD \
 -d . \
 -R rulesets/java/ali-comment.xml,rulesets/java/ali-concurrent.xml,rulesets/java/ali-constant.xml,rulesets/java/ali-exception.xml,rulesets/java/ali-flowcontrol.xml,rulesets/java/ali-naming.xml,rulesets/java/ali-oop.xml,rulesets/java/ali-orm.xml,rulesets/java/ali-other.xml,rulesets/java/ali-set.xml \
 -f text -shortnames -no-cache -min 1
if [ $? -ne 0 ]; then
 echo "[pre-commit] p3c-pmd found violations, commit rejected"
 exit 1
fi
EOF
chmod +x .git/hooks/pre-commit

六、服务端提交检查：pre-receive 钩子

客户端检查是"自愿"的——开发者完全可以 --no-verify 绕过。真正守门的是服务端 pre-receive 钩子——push 时服务端自动跑，违规直接 reject。

6.1 在 Gitea 容器内装 p3c

Gitea 默认镜像是 Alpine（没有 JDK），所以需要 gitea:1.23.5-jdk8 这个带 JDK8 的版本。

把 JDK 复制到 Gitea 容器：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


docker cp /usr/local/jdk gitea:/usr/local/
docker exec -it gitea bash

# 容器内: 配置环境变量
vim /etc/profile
export JAVA_HOME=/usr/local/jdk/jdk1.8.0_371
export CLASSPATH=$JAVA_HOME/bin:$JAVA_HOME/lib:$JAVA_HOME/jre/lib
export PATH=.:$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH
source /etc/profile

# 容器内: 装 glibc（alpine 镜像需要）
sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories
apk update
apk add glibc-2.35-r1.apk
apk add glibc-bin-2.35-r1.apk
apk add glibc-i18n-2.35-r1.apk
ln -sf /usr/glibc-compat/lib/ld-linux-x86-64.so.2 /lib64/ld-linux-x86-64.so.2

# 验证
java -version

把 p3c-pmd 工具复制到容器：

1
2
3
4
5


# 宿主机: 编译 p3c-pmd
cd p3c-pmd
mvn clean package
docker cp p3c-pmd-2.1.1-jar-with-dependencies.jar gitea:/
docker cp rulesets gitea:/var/opt

容器内跑一次（验证）：

1
2
3
4
5


java -Dfile.encoding=utf-8 -Dpmd.language=zh \
 -cp /data/p3cjava/p3c-pmd-2.1.1-jar-with-dependencies.jar net.sourceforge.pmd.PMD \
 -d /data/p3cjava/tmp \
 -R /data/p3cjava/rulesets/java/ali-comment.xml,/data/p3cjava/rulesets/java/ali-concurrent.xml,... \
 -f text -shortnames -no-cache

6.2 写 pre-receive 钩子

Gitea 仓库路径：/data/git/repositories/<org>/<repo>.git/hooks/pre-receive

1

chmod 755 /data/git/repositories/<org>/<repo>.git/hooks/pre-receive.d/pre-receive

钩子脚本：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


#!/usr/bin/env bash
# /data/git/repositories/<org>/<repo>.git/hooks/pre-receive.d/pre-receive

set -e

# 读取 push 信息
# 格式: <oldrev> <newrev> <refname>
while read oldrev newrev refname; do
 # 找到这次 push 涉及的所有 .java 文件
 if [ "$oldrev" = "0000000000000000000000000000000000000000" ]; then
 # 新分支 push
 files=$(git diff-tree --root --no-commit-id --name-only -r $newrev | grep '\.java$' || true)
 else
 # 普通 push
 files=$(git diff --name-only $oldrev $newrev | grep '\.java$' || true)
 fi

 if [ -z "$files" ]; then
 continue
 fi

 # 复制这些文件到 p3c 检查目录
 mkdir -p /data/p3cjava/tmp
 for f in $files; do
 mkdir -p "/data/p3cjava/tmp/$(dirname "$f")"
 git show "$newrev:$f" > "/data/p3cjava/tmp/$f" 2>/dev/null || continue
 done

 # 跑 p3c-pmd
 result=$(java -Dfile.encoding=utf-8 -Dpmd.language=zh \
 -cp /data/p3cjava/p3c-pmd-2.1.1-jar-with-dependencies.jar net.sourceforge.pmd.PMD \
 -d /data/p3cjava/tmp \
 -R /data/p3cjava/rulesets/java/ali-comment.xml,/data/p3cjava/rulesets/java/ali-naming.xml,... \
 -f text -shortnames -no-cache 2>&1 || true)

 if [ -n "$result" ]; then
 echo "$result"
 echo ""
 echo "p3c-pmd found violations, push rejected"
 exit 1
 fi
done

# 检查通过
exit 0

1

chmod +x /data/git/repositories/<org>/<repo>.git/hooks/pre-receive.d/pre-receive

6.3 黑白名单机制

真实场景：某些"特殊项目"（如 demo 仓库、迁移中的老代码）暂时不想被 p3c 拦截——又不能让所有人手动去改钩子。

思路：

黑名单：默认所有项目都不拦截；只有 BLACKLIST 里的项目才走 p3c 检查
白名单：黑名单 + p3c 检查完后，如果在 WHITELIST 里 → 强制通过
用户白名单：某些核心开发（架构师）有"豁免权"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


#!/usr/bin/env bash
# /data/git/repositories/<org>/<repo>.git/hooks/pre-receive.d/pre-receive

set -e

REPO_NAME=$(basename $(pwd) .git) # 仓库名
USER_NAME=$(echo $GL_REPOSITORY | awk -F/ '{print $NF}')

BLACKLIST=("legacy-code" "demo-project" "old-billing")
WHITELIST=("template" "scaffolding")
USER_WHITELIST=("admin" "architect")

# 黑名单检查
should_check=false
for b in "${BLACKLIST[@]}"; do
 if [ "$REPO_NAME" = "$b" ]; then
 should_check=true
 break
 fi
done

if [ "$should_check" = false ]; then
 exit 0
fi

# 用户白名单检查
for u in "${USER_WHITELIST[@]}"; do
 if [ "$USER_NAME" = "$u" ]; then
 echo "[pre-receive] $USER_NAME is in user whitelist, skip p3c check"
 exit 0
 fi
done

# 跑 p3c 检查（见 6.2）
# ...

坑 8：GL_REPOSITORY 是 Gitea 内置变量，只有在 Gitea 容器内跑的钩子才能拿到。如果在客户端写钩子用这个变量是空的。

七、常见排错

7.1 Gitea SSH 推送失败 “permission denied”

症状：git push 报 Permission denied (publickey)。

排查：

客户端 SSH 密钥是否加到 Gitea（User Settings → SSH Keys）
Gitea 容器内 /data/git/.ssh 是否存在
容器端口映射是否对（10022:22）
客户端 ~/.ssh/config 是否写错了 host 别名

7.2 p3c-pmd 报错 “java not found”

症状：Gitea 容器内跑 p3c 报 java: command not found。

解决：

用 gitea:1.23.5-jdk8 镜像（自带 JDK）
或手动复制 JDK 进容器并配 JAVA_HOME（见 6.1）

7.3 pre-receive 钩子 “权限拒绝”

症状：钩子写好了，但 push 时没执行。

排查：

1
2
3
4
5
6
7


# 1. 钩子文件是否可执行
ls -la /data/git/repositories/<org>/<repo>.git/hooks/pre-receive
# 必须是 -rwxr-xr-x
chmod +x /data/git/repositories/<org>/<repo>.git/hooks/pre-receive

# 2. Gitea 用户是否能写
chown -R git:git /data/git/repositories/<org>/<repo>.git/hooks

7.4 客户端 p3c 跑得慢

症状：每次 git commit 跑 p3c 要 30 秒+。

解决：

用 maven-pmd-plugin 自带的 cache 选项
缩小规则集（先只跑 ali-naming.xml 和 ali-comment.xml）
在 pre-commit 脚本里加 git diff——只检查本次 commit 修改的文件，不扫全工程

1
2


# 优化后的 pre-commit: 只检查 staged 文件
files=$(git diff --cached --name-only --diff-filter=ACM | grep '\.java$')

八、写在最后

Gitea / Gitblit / Gogs 三选一，绝大多数情况直接选 Gitea——社区活跃、CI 内置、UI 现代、迁移工具完善。配 p3c-pmd 做提交前检查才是真正的"省心"——把代码规范固化到提交链路里，而不是每次都"代码 review 时再吐槽"。

下一步建议：

Gitea Actions：和 GitHub Actions 兼容的 CI，仓库根目录 .gitea/workflows/*.yml
Gitea 自定义主题：通过 templates/custom/ 改 logo / 配色
Gitea → Gitea Federation：跨 Gitea 实例同步仓库（实验特性）

参考资料

Gitea 官方文档：https://docs.gitea.cn/
Gitea Docker 镜像：https://hub.docker.com/r/gitea/gitea
p3c-pmd 工具：https://github.com/alibaba/p3c
githook-maven-plugin：https://github.com/phillipuniverse/githook-maven-plugin
Gitblit 官网：http://gitblit.com/
Gogs 官网：https://gogs.io/
PMD 命令行参考：https://pmd.github.io/pmd/pmd_userdocs_cli_reference.html

Windows 开发工具链：bun / nvm / gh / jq / ripgrep / Neovim / Git 实战

Mon, 15 Jan 2018 00:00:00 +0800

一、bun：Node.js 的高性能替代

bun 是 2022 年后崛起的 JavaScript 运行时（Zig 写），比 Node.js 快 3~4 倍，自带包管理器 / TS 编译器 / 测试运行器。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# Linux
curl -fsSL https://bun.com/install | bash

cat << 'EOF' >> ~/.zshrc
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
EOF

source ~/.zshrc
bun -v
bun upgrade

1
2


# Windows
powershell -c 'irm bun.sh/install.ps1|iex'

二、nvm + Node 多版本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 写入 .zshrc
cat << 'EOF' >> ~/.zshrc
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
EOF

source ~/.zshrc

nvm ls-remote
nvm install v22.22.3
node -v

三、GitHub CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


# Linux (Debian)
(type -p wget >/dev/null || (sudo apt update && sudo apt install wget -y)) \
 && sudo mkdir -p -m 755 /etc/apt/keyrings \
 && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
 && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
 && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
 && sudo mkdir -p -m 755 /etc/apt/sources.list.d \
 && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
 && sudo apt update \
 && sudo apt install gh -y

gh --version

# 更新
sudo apt update && sudo apt install gh

# Windows
scoop install gh

授权

1
2
3
4
5
6


git config --global user.name "Your Name"
git config --global user.email "your@email.com"

gh auth login
# Github.com -> HTTPS -> Auth? YES -> Paste an auth token
# 输入 gh pat 创建即可

四、jq + ripgrep + uvx：文本三剑客

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# jq - JSON 处理
apt install jq # Linux
scoop install jq jid # Windows
jq -V

# ripgrep - 替代 grep
apt install ripgrep # Linux
scoop install ripgrep # Windows
rg -V

# uvx - Python 工具运行（uv 是新一代 pip）
curl -LsSf https://astral.sh/uv/install.sh | sh
which uvx

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
(Get-Command uvx).source

五、Neovim + LazyVim

1
2
3
4
5


# Linux
sudo apt install neovim -y

# Windows
scoop install neovim

LazyVim 需求

Neovim >= 0.11.2（需 LuaJIT）
Git >= 2.19.0（partial clone）
Nerd Font v3.0+（图标，可选）
lazygit（可选）
tree-sitter-cli + C compiler
curl（blink.cmp 引擎）
fzf v0.25.1+、ripgrep、fd

安装

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# Linux
sudo apt install -y build-essential fzf fd-find lazygit
fzf --version
fdfind -V

mv ~/.config/nvim{,.bak}
git clone https://github.com/LazyVim/starter ~/.config/nvim
rm -rf ~/.config/nvim/.git

echo 'export EDITOR=nvim' >> ~/.zshrc
source ~/.zshrc

# 字体
git clone --depth 1 https://github.com/ryanoasis/nerd-fonts.git ~/workspace/github/nerd-fonts
cd ~/workspace/github/nerd-fonts
./install.sh JetBrainsMono

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Windows
scoop bucket add extras
scoop install lazygit
scoop install fzf fd
npm install -g tree-sitter-cli
winget install --id=BrechtSanders.WinLibs.POSIX.UCRT -e -s winget

Move-Item $env:LOCALAPPDATA\nvim $env:LOCALAPPDATA\nvim.bak
git clone https://github.com/LazyVim/starter $env:LOCALAPPDATA\nvim
Remove-Item $env:LOCALAPPDATA\nvim\.git -Recurse -Force

LazyVim 快捷键

LazyVim 用 which-key.nvim 弹窗展示快捷键。默认：

<leader> = <space>
<localleader> = \

按 <space> 即可看到所有以空格开头的快捷键。

六、Git 高级用法

全局忽略

1

git config --global core.excludesFile ~/.gitignore_global

Git LFS

1
2


git lfs install
# Git LFS initialized.

SSH + GitHub

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


# 1. 生成密钥（~/.ssh/{id_ed25519,id_ed25519.pub}）
ssh-keygen -t ed25519 -C "your@email.com"

# 2. 配置 ~/.ssh/config（GitHub 443 端口兜底）
Host github.com
 HostName ssh.github.com
 Port 443
 User git
 IdentityFile ~/.ssh/id_ed25519

# 3. 把公钥配置到 GitHub（Settings -> SSH and GPG keys）
cat ~/.ssh/id_ed25519.pub
# ssh-ed25519 AAAA... your@email.com

# 4. 测试
ssh -Tv git@github.com

# 5. 拉取 fork 项目并跟踪上游
git clone git@github.com:yourname/project.git
cd project
git remote add upstream https://gitlab.com/original/project.git

# 6. 学习分支
git checkout -b study-notes
git add .
git commit -m "feat: 学习笔记 - 渲染管线初始化逻辑说明"

# 7. 同步官方
git fetch upstream
git rebase upstream/master
# 冲突时合并
git add <冲突文件>
git rebase --continue
# 强制推送
git push origin study-notes --force

# 8. master 对齐官方
git checkout master
git pull upstream master
git push origin master

七、Umi-OCR：离线 OCR

1
2


scoop bucket add extras
scoop install extras/umi-ocr-paddle

八、常用命令（PowerShell）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 打开资源管理器当前位置
ii .

# 查端口的 PID
netstat -ano | findstr "32767"

# 查 PID 的进程
tasklist | findstr "15764"

# 结束进程
taskkill /F /PID 2932
taskkill /f /t /im AxureRP9.exe

# 创建文件
New-Item -Path .\文件名.后缀 -ItemType File
ni 文件名.后缀 # 简化写法

下一步

想把 VSCode / IDEA 用上这些工具，看 2019-04-15《AI 编程工具链》
想用 WezTerm 当主力终端，看 2017-11-15《Windows 终端与 Shell 工具链》

参考资料

bun 官方：https://bun.sh
nvm 官方：https://github.com/nvm-sh/nvm
GitHub CLI：https://cli.github.com
ripgrep：https://github.com/BurntSushi/ripgrep
uv：https://github.com/astral-sh/uv
LazyVim：https://www.lazyvim.org

Git 四大区与 Shelve 搁置：从入门到 IDEA 实战

Tue, 15 Sep 2015 00:00:00 +0800

Git 四大区

Git 内部有 4 个工作区域：

区域	英文	说明
工作区	Working Directory	本地写代码的目录
暂存区	Staging Area / Index	`git add` 后的"准备提交"区
本地仓库	Local Repository	`git commit` 后的本地历史
远程仓库	Remote Repository	`git push` 后的云端历史

1
2
3
4


工作区（写代码）
 → git add → 暂存区（准备提交） git stash 隐藏更改
 → git commit → 本地仓库（本地保存）
 → git push → 远程仓库（云端保存）

git stash 是隐藏工作区的更改到栈里（不提交到任何区），方便你拉最新代码或者切换任务。

git stash：紧急任务切换

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 当前正在改功能 A，写了一半
# 突然来了 bugB 要修

# 1. 把功能 A 暂存起来
git stash

# 2. 拉最新代码
git pull origin master

# 3. 切到 bug 分支修
git checkout -b fix-bugB
# ... 改完、commit、push、merge ...

# 4. 切回功能 A 分支
git checkout feature-A

# 5. 恢复暂存
git stash pop

# 6. 继续功能 A 开发

stash 是栈结构，支持多个：

1
2
3
4
5


git stash # 暂存当前
git stash list # 查看所有 stash
git stash apply stash@{0} # 应用指定 stash
git stash drop stash@{0} # 删除指定 stash
git stash pop # 应用并删除最近一个

git restore：撤销本地的编辑

1
2
3
4
5
6
7
8


# 撤销工作区的修改（未 add）
git restore 文件1 文件2

# 撤销暂存（已 add，但未 commit）
git restore --staged 文件1 文件2

# 撤销工作区 + 暂存
git restore --staged --worktree 文件1

IDEA 中的回滚：

VCS → Git → Restore File：相当于 git restore
Local History → Show History：IDEA 自动保存的本地历史
VCS → Git → Reset HEAD：回滚所有未提交修改

IDEA 的 reset 默认不删除"已提交"的文件副本，所以回滚不删除文件——已跟踪的文件从绿变红。

git HEAD：指针机制

HEAD 是当前分支最新提交的"指针"。

HEAD^：上一个提交（HEAD~1）
HEAD^^：上上一个（HEAD~2）
HEAD@{2}：reflog 中第 3 个 HEAD 位置（用于找回 reset 掉的 commit）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 查看 reflog
git reflog

# 把 HEAD 切到上一个提交
git checkout HEAD^

# 恢复误删的分支
git reflog
# 找到 commit SHA
git checkout -b recovered-branch <SHA>

git restore vs git checkout vs git reset 三者区别

命令	作用
`git restore <file>`	撤销工作区/暂存区的修改（Git 2.23+ 新命令）
`git checkout -- <file>`	同上（旧语法）
`git reset --soft HEAD^`	撤销 commit，保留暂存
`git reset --mixed HEAD^`	撤销 commit + 暂存，保留工作区
`git reset --hard HEAD^`	撤销 commit + 暂存 + 工作区（危险，慎用）

IDEA 的 Shelve 搁置

什么是 Shelve

IDEA 的 Shelve（搁置） 是 JetBrains IDE 独有的功能，定位：

【任务切换神器】 不是为了拉代码，是为了 把写一半的功能收起来，去干别的事。

它像一个临时的、私有的、微型补丁分支——不污染 git 历史，跨分支切换时不被带走。

使用场景

1
2
3
4
5
6
7
8


正在写【功能 A】，写了一半
突然来了【紧急 bugB】要修！
不想提交 A，也不想删 A

→ 把 A 搁置（Shelve）起来
→ 工作区变干净
→ 去修 bugB
→ 修完把 A 恢复回来继续

操作步骤

Git → Uncommitted Changes → Shelve Changes…
命名（建议"功能A-2026-06-04"）
工作区立刻变干净
切到 bugB 分支修
修完提交
Git → Uncommitted Changes → Unshelve… 选之前搁置的名字
恢复继续功能 A

与 git stash 的区别：Shelve 是 IDE 本地的，跨电脑不共享；stash 是 git 仓库级别的，commit 后可推送。

git-crypt：透明加密

团队项目经常需要提交敏感配置（.env、数据库密码），但又怕直接 push 到公网。git-crypt 是 Git 的透明加密插件：

文件本地是明文
git push 后云端是密文
团队成员对称加密：每个有 GPG key 的人都能解密

1
2
3
4
5
6
7
8


# Linux 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-linux-x86_64

# Windows 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-x86_64.exe

# 放到 PATH
mv git-crypt-0.7.0-x86_64 /usr/local/bin/git-crypt

配置 .gitattributes

1
2
3
4
5


# .gitattributes
.env filter=git-crypt diff=git-crypt
config/prod.yaml filter=git-crypt diff=git-crypt
*.key filter=git-crypt diff=git-crypt
*.pem filter=git-crypt diff=git-crypt

初始化

1
2
3


git-crypt init
git add .gitattributes
git commit -m "Add git-crypt config"

添加 GPG 协作者

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 协作者生成 GPG key
gpg --gen-key
# 上传公钥到 keyserver
gpg --keyserver keys.openpgp.org --send-keys <KEY_ID>

# 信任他
git-crypt add-gpg-user <GPG_USER_ID>

# 协作者 clone 后 unlock
git-crypt unlock

常用命令速查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# 远程分支
git branch -r

# 检出远程分支
git checkout release_V3.1.4

# 关联分支
git branch --set-upstream-to=origin/master master

# 查看单个文件的历史
git log -p -- path/to/file

# 暂存部分文件
git add -p
# y/n/q/a/d 等交互式命令

# 撤销合并
git revert -m 1 <merge_commit_sha>

# 修改最后一次 commit
git commit --amend

# 改作者邮箱（全局）
git filter-branch --env-filter 'GIT_AUTHOR_EMAIL=xxx'

下一步

想用 GitHub Actions 自动化 CI，看 2017-12-08《K8s Ingress 实战》
想用 monorepo 工具（pnpm + turbo）管理多项目，看 2020-04-15《FSS 全栈脚手架》

参考资料

Pro Git 简体中文：https://git-scm.com/book/zh/v2
git-crypt：https://github.com/AGWA/git-crypt
IDEA Shelve 文档：https://www.jetbrains.com/help/idea/shelving-and-unshelving-changes.html

Git 与版本控制实战：从入门到 GitHub 高级搜索

Sat, 15 Nov 2014 00:00:00 +0800

一、Git 在 2014 的地位

2014 年的 Git 已经基本统一了分布式版本控制市场。GitHub 2014 年 1 月用户突破 1000 万（2008 年成立，2013 年用户 300 万），国内 GitCafe、coding.net 同期兴起。本文整理 Git 从入门到 GitHub 高级搜索的完整工作流。

阅读建议：本文面向用过 SVN 切换到 Git 的开发者，重点在Git 概念 + 实战命令。

二、Git 安装与初始配置

2.1 安装

Windows：https://git-scm.com/download/win（Git for Windows，带 Git Bash）
macOS：brew install git（或装 Xcode Command Line Tools）
Linux：apt install git / yum install git

2.2 全局配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 必填：用户名 + 邮箱
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 推荐：默认编辑器
git config --global core.editor "vim"

# 推荐：默认分支名（Git 2.28+）
git config --global init.defaultBranch main

# 推荐：换行符处理（Windows 推荐）
git config --global core.autocrlf true

2.3 SSH 密钥登录 GitHub

生成密钥对：

1
2
3


ssh-keygen -t ed25519 -C "you@example.com"
# 或传统 RSA
ssh-keygen -t rsa -b 4096 -C "you@example.com"

复制公钥：

1
2
3
4
5
6


# Windows (Git Bash)
clip < ~/.ssh/id_ed25519.pub
# macOS
pbcopy < ~/.ssh/id_ed25519.pub
# Linux
cat ~/.ssh/id_ed25519.pub

GitHub Settings → SSH and GPG keys → New SSH key，粘贴。

验证：

1
2


ssh -T git@github.com
# 输出：Hi <username>! You've successfully authenticated...

2.4 HTTPS + Token 登录（GitHub 2021+ 强制）

2021-08 GitHub 取消密码推送，必须用 Personal Access Token (PAT)：

GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token
勾选 repo、gist、read:org、workflow
复制 token（只显示一次）

克隆时用 token：

1

git clone https://<TOKEN>@github.com/username/repo.git

IDEA 中：登录 GitHub 时填 token，不要用账户密码

三、Git 核心命令

3.1 本地仓库

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# 初始化
git init
git init my-project
git clone https://github.com/xxx/repo.git

# 查看状态
git status
git log --oneline --graph --decorate --all

# 暂存与提交
git add <file>
git add . # 当前目录所有
git add -p # 交互式分块
git commit -m "msg"
git commit -am "msg" # add tracked files + commit

# 撤销
git checkout -- <file> # 丢弃工作区修改
git reset HEAD <file> # 取消暂存
git reset --soft HEAD~1 # 撤销 commit，保留暂存
git reset --hard HEAD~1 # 撤销 commit，丢弃修改（危险）
git revert <commit> # 反向 commit（安全）

3.2 分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 创建与切换
git branch <name> # 创建
git checkout <name> # 切换
git checkout -b <name> # 创建并切换
git switch <name> # Git 2.23+
git switch -c <name> # 创建并切换

# 推送与拉取
git push origin <branch>
git pull origin <branch>
git pull --rebase origin <branch> # 拉取后变基

# 合并
git merge <branch>
git merge --no-ff <branch> # 保留分支历史
git rebase <branch> # 变基（线性历史）

3.3 远程

1
2
3
4
5


git remote -v
git remote add origin https://github.com/xxx/repo.git
git remote set-url origin <new-url>
git fetch origin
git fetch --all

3.4 标签

1
2
3
4
5
6


git tag # 列出本地标签
git tag v1.0.0 # 轻量标签
git tag -a v1.0.0 -m "msg" # 附注标签
git push origin v1.0.0 # 推送单个
git push origin --tags # 推送所有
git checkout v1.0.0 # 切到标签

3.5 Stash（暂存工作区）

1
2
3
4


git stash # 暂存当前修改
git stash pop # 恢复
git stash list # 列出
git stash apply stash@{0} # 应用指定

四、`.gitignore` 模板

4.1 Java 项目

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


# 编译产物
target/
build/
out/
*.class
*.jar
*.war

# IDE
.idea/
.vscode/
*.iml
*.iws
*.ipr
.project
.classpath
.settings/

# 日志
*.log
logs/

# 系统
.DS_Store
Thumbs.db

# 密钥
*.pem
*.key
secrets.yaml

4.2 Node 项目

1
2
3
4
5
6
7


node_modules/
npm-debug.log
.env
.env.local
dist/
.next/
.nuxt/

4.3 Python 项目

1
2
3
4
5
6
7


__pycache__/
*.pyc
.venv/
venv/
*.egg-info/
.pytest_cache/
.mypy_cache/

五、分支管理策略

5.1 Git Flow（2010 年 Vincent Driessen 提出）

1
2
3
4
5


master（生产）
 └── hotfix-*（紧急修复）
develop（开发）
 ├── feature-*（功能）
 └── release-*（预发布）

master：每个 commit 都是稳定版本，打 tag
develop：日常开发主分支
feature/*：功能分支，开发完 merge 回 develop
release/*：预发布分支，测试通过后 merge 到 master + develop
hotfix/*：紧急修复，直接从 master 拉，修完 merge 回 master + develop

5.2 GitHub Flow（2011 年 GitHub 提出）

只有 main + feature 分支：

从 main 拉 feature 分支
提交 + 推送到 GitHub
开 Pull Request
CI/CD 自动跑
Code Review
合并到 main
main 自动部署

适合：持续部署、单一版本的产品。

5.3 Trunk-Based Development（主干开发）

所有人在 main 上开发，短期分支（< 1 天）：

Feature flag：用代码开关控制新功能
每提交必测：CI 跑全量测试
每日合并：避免长寿命分支

适合：超大规模团队（Google、Facebook）。

六、GitHub 高级搜索

GitHub 搜索语法 2013 年就成熟了，对找开源项目、找开发者极有用。

6.1 关键词

语法	含义
`in:name xxx`	仓库名含 xxx
`in:description xxx`	描述含 xxx
`in:readme xxx`	README 含 xxx

6.2 数量

语法	含义
`stars:>xxx`	star > xxx
`stars:xx..xx`	star 在范围内
`forks:>xxx`	fork > xxx

6.3 地区/语言

语法	含义
`location:china`	地区
`language:javascript`	主语言

6.4 大小/日期

语法	含义
`size:>=5000`	仓库大小（KB）
`pushed:>2020-01-01`	最后 push 时间
`created:>2020-01-01`	创建时间

6.5 找组织/开发者

语法	含义
`user:xxx`	找用户
`org:xxx`	找组织
`followers:>=xxx`	关注者数量

6.6 License

语法	含义
`license:apache-2.0`	Apache 2.0
`license:mit`	MIT
`license:gpl-3.0`	GPL 3.0

6.7 实战示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 找 Java 写的、star > 10k 的 Spring Boot 项目
language:java spring boot stars:>10000

# 找 2020 年后更新的 Python 机器学习项目
language:python machine learning pushed:>2020-01-01

# 找 Apache 2.0 协议的 React 组件
react license:apache-2.0 in:readme

# 找来自中国的 JavaScript 全栈开发者
language:javascript location:china followers:>100

七、常用 Git 工作流

7.1 Fork 同步上游

Fork 别人的仓库后，怎么同步上游更新？

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 关联上游仓库
git remote add upstream https://github.com/original-owner/repo.git
git remote -v

# 2. 拉取上游更新
git fetch upstream
git checkout main
git merge upstream/main

# 3. 推到自己 Fork
git push origin main

7.2 Git-FTP：用 FTP 部署静态站点

git-ftp 工具（https://github.com/git-ftp/git-ftp）让 Git 管理 FTP 部署：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 安装
# Windows: scoop install git-ftp
# macOS: brew install git-ftp

# 初始化
git ftp init --user <USER> --passwd <PASS> ftp://host/

# 部署
git ftp push --user <USER> --passwd <PASS> ftp://host/

# 只部署 master
git ftp push --syncroot . --user <USER> --passwd <PASS> ftp://host/

适用：没有 CI/CD 的小项目，纯 FTP 部署。

7.3 Git 配合 Jenkins

Jenkinsfile 经典写法：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


pipeline {
 agent any
 stages {
 stage('Checkout') {
 steps {
 git branch: 'main',
 url: 'https://github.com/xxx/repo.git',
 credentialsId: 'github-token'
 }
 }
 stage('Build') {
 steps {
 sh 'mvn clean package -DskipTests'
 }
 }
 stage('Test') {
 steps {
 sh 'mvn test'
 }
 }
 stage('Deploy') {
 when { branch 'main' }
 steps {
 sh 'mvn deploy'
 }
 }
 }
}

7.4 Git 标签发版

1
2
3
4
5
6
7
8


# 发版流程
git checkout main
git pull
# 写 CHANGELOG
git tag -a v1.5.0 -m "Release 1.5.0"
git push origin v1.5.0

# GitHub 上：Releases → Draft a new release → 选 tag → 写变更

八、Git 内部原理

8.1 三个区

1
2
3
4
5
6
7


工作区（Working Directory）
 ↓ git add
暂存区（Staging / Index）
 ↓ git commit
本地仓库（Repository / .git）
 ↓ git push
远程仓库（Remote）

8.2 Git 对象

blob：文件内容
tree：目录结构
commit：一次提交（含 tree + parent + author + message）
tag：标签对象

每个对象都有 SHA-1 hash，git cat-file -p <hash> 看内容。

8.3 分支本质

分支是 commit 的指针。.git/refs/heads/main 文件里就一个 40 字符的 hash。

1
2
3


# 查看分支指向
cat .git/refs/heads/main
# 输出：a1b2c3d4e5f6...

九、常见问题

9.1 “Failed to connect to github.com port 443: Timed out”

1
2
3
4
5
6
7


# 设代理
git config --global http.proxy http://127.0.0.1:1081
git config --global https.proxy http://127.0.0.1:1081

# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

9.2 “Could not resolve host: github.com”

1
2
3
4


# 改 hosts（Windows 路径：C:\Windows\System32\drivers\etc\hosts）
# 注意：先去掉"只读"属性
140.82.112.4 github.com
140.82.112.3 github.com

或者用 SwitchHosts 工具可视化编辑。

9.3 “Your branch is ahead of ‘origin/main’ by N commits”

1

git push origin main

9.4 合并冲突

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 1. 拉取冲突代码
git pull origin main
# 输出：CONFLICT (content): Merge conflict in <file>

# 2. 打开文件，找到冲突标记
<<<<<<< HEAD
你的代码
=======
别人的代码
>>>>>>> branch-name

# 3. 手动编辑（保留你想要的）

# 4. 标记为已解决
git add <file>
git commit -m "resolve conflict"

9.5 “Permission denied (publickey)”

1
2
3
4
5
6
7
8


# 检查 SSH key 是否加载
ssh-add -l

# 如果没加载
ssh-add ~/.ssh/id_ed25519

# 测试连接
ssh -T git@github.com

9.6 误删分支恢复

1
2
3
4
5


# 1. 找到最后一次 commit hash
git reflog

# 2. 重建分支
git checkout -b <branch> <hash>

9.7 .git 占用空间过大

1
2
3
4
5
6


# 清理大文件历史
git gc --aggressive --prune=now
# 或用 BFG Repo-Cleaner
bfg --delete-files "*.jar" --no-blob-protection
git reflog expire --expire=now --all
git gc --prune=now --aggressive

十、下一步

想看 Java 主力 IDE：[2014-04-15 IntelliJ IDEA 全攻略]
想看 CI/CD：项目全流程 章节中的 Jenkins 实战
想看 Git 托管平台对比：[2021-05-10 开源生态观察]

本文写于 2014 年，回看当时：Git 2.1 是当时最新版，git switch / git restore 还没出来（2019 年 2.23 才发布）；GitHub 高级搜索语法至今未大变；Git Flow 在 2014 已是行业事实，但 2017 年后 Trunk-Based 越来越流行——Git 工作流的演化反映了 CI/CD 文化的演进。

Git on Liangweidong's blog

自托管 Git 平台镜像实战：Gitea / Gitblit / Gogs 部署与提交前代码规范检查

一、三款 Git 平台对比

二、Gitea 部署（推荐）

2.1 镜像选择

2.2 docker run 启动

2.3 docker-compose 启动

2.4 关键配置

2.5 创建第一个仓库

2.6 升级路径

三、Gitblit 部署

四、Gogs 部署

五、客户端提交前检查：p3c-pmd

5.1 准备 p3c-pmd 工具

5.2 手动跑一次（验证工具）

5.3 Maven 集成（开发期自动跑）

5.4 手动安装 pre-commit 钩子（不依赖 Maven）

六、服务端提交检查：pre-receive 钩子

6.1 在 Gitea 容器内装 p3c

6.2 写 pre-receive 钩子

6.3 黑白名单机制

七、常见排错

7.1 Gitea SSH 推送失败 “permission denied”

7.2 p3c-pmd 报错 “java not found”

7.3 pre-receive 钩子 “权限拒绝”

7.4 客户端 p3c 跑得慢

八、写在最后

参考资料

Windows 开发工具链：bun / nvm / gh / jq / ripgrep / Neovim / Git 实战

一、bun：Node.js 的高性能替代

二、nvm + Node 多版本

三、GitHub CLI

授权

四、jq + ripgrep + uvx：文本三剑客

五、Neovim + LazyVim

LazyVim 需求

安装

LazyVim 快捷键

六、Git 高级用法

全局忽略

Git LFS

SSH + GitHub

七、Umi-OCR：离线 OCR

八、常用命令（PowerShell）

下一步

参考资料

Git 四大区与 Shelve 搁置：从入门到 IDEA 实战

Git 四大区

git stash：紧急任务切换

git restore：撤销本地的编辑

git HEAD：指针机制

git restore vs git checkout vs git reset 三者区别

IDEA 的 Shelve 搁置

什么是 Shelve

使用场景

操作步骤

git-crypt：透明加密

配置 .gitattributes

初始化

添加 GPG 协作者

常用命令速查

下一步

参考资料

Git 与版本控制实战：从入门到 GitHub 高级搜索

一、Git 在 2014 的地位

二、Git 安装与初始配置

2.1 安装

2.2 全局配置

2.3 SSH 密钥登录 GitHub

2.4 HTTPS + Token 登录（GitHub 2021+ 强制）

三、Git 核心命令

3.1 本地仓库

3.2 分支

3.3 远程

3.4 标签

3.5 Stash（暂存工作区）

四、.gitignore 模板

4.1 Java 项目

4.2 Node 项目

4.3 Python 项目

四、`.gitignore` 模板