JerryLife

安卓Root的选择与使用教程指南

Mon, 05 Oct 2026 00:00:00 GMT

一、先搞清楚：Root 到底是什么#

很多人以为「Root」是某个 App，装上就够了。实际上它是一个框架 + 一个管理界面的统称：

组成	作用
Root 框架	真正拿到 root 权限的那层代码（Magisk / KernelSU / APatch）
管理器 App	授予/撤销 App 的 root 权限、装模块、看日志的界面
su 二进制	其他 App 通过它申请提权
模块（Modules）	各种第三方扩展：去广告、改系统字体、装 Lsposed 框架等

现在还在维护的主流框架只有三个：Magisk、KernelSU、APatch。老一代的 SuperSU、KingRoot、Root 守护程序（RootCloak）这类「改 system 分区」方案已经不适用于当前的安卓系统。

二、三大框架对比#

2.1 核心差异#

维度	Magisk	KernelSU	APatch
root 位置	用户空间，直接注入到 boot 镜像	内核空间，内核内置或 LKM 加载	内核空间，直接 patch 内核
需要自定义内核	否	否（用官方预编译 LKM）/ 是（GKI编译）	否
修补的镜像	`boot.img`	`boot.img`或`init_boot.img`	`boot.img`
Zygisk	原生支持	需另装 ZygiskNext	需另装 ZygiskNext
模块生态	历史久远，模块最全最多	原生模块仅数百个，但兼容大部分 Magisk 模块	原生模块较少，另支持 KPM 内核模块
上手难度	最低	中等	中等
对银行 App 兼容性/隐藏能力	需模块组合	最好（内核级授权）	较好

2.2 版本现状（截至 2026-10）#

项目	最新版本	发布日期	官方仓库
Magisk	v30.7	2026-02-23	`topjohnwu/Magisk`
KernelSU	v3.3.0	2026-08-28	`tiann/KernelSU`
APatch	11224	2026-08-07	`bmax121/APatch`

Magisk v30.7 更新要点：

[MagiskInit] Support Android 16 QPR2 sepolicy format
[MagiskInit] Support using klogdump partition as pre-init storage
[Zygisk] Support Android 16 QPR2 and higher
[Zygisk] Support Android XR and some Nubia devices
[MagiskSU] Do not drop capabilities by default, even when switching to non-root UIDs. Explicitly use the argument to drop capabilities.--drop-cap
[MagiskBoot] Better lzma format detection
[MagiskBoot] Fix various commandline argument parsing bugs

KernelSU v3.3.0 更新要点：

新增 x86_64 LKM 支持
新增 Android 17 + Linux 6.18 支持，修复 6.6 内核 backport 场景
从文件修补启动镜像时自动备份原始 stock image
su 支持设置 SELinux context
官方 Release 直接提供预编译 .ko，覆盖内核版本：5.10 / 5.15 / 6.1 / 6.6 / 6.12 / 6.18

Apatch 11224 更新要点：

修复已知问题

三、怎么选#

Magisk（含 Delta/Alpha）#

优点：生态最大，模块最多，LSPosed 最稳；新手首选；老机型（内核 < 5.10）兼容性强；自带 Zygisk+Denylist，上手简单
缺点：底层权限不如内核级，部分强检测环境难隐藏
适合：新手、普通模块玩家、老手机、不想折腾内核补丁、主要用 LSPosed

KernelSU（KSUN/SukiSU-Ultra 分支更强）#

优点：内核级权限，隐藏上限高（搭配 SUSFS）；权限管控精细；现代 GKI 安卓（5.10+）首选内核 RootKernelSU
缺点：原生不带 Zygisk，需要 ZygiskNext；模块生态略少于 Magisk；老非 GKI 机型麻烦
适合：GKI 新手机、需要强隐藏（银行 / 游戏检测）、内核模块玩家

APatch（首选FolkPatch分支，功能更多）#

优点：支持超广内核 3.18~6.12，很多非 GKI 救星；内置 Magic Mount、KPM 自动加载；内核级路径隐藏；不需要预编译内核，直接 patch 原厂 boot
缺点：模块生态小于 Magisk；APatch 底层，玩机门槛更高；小众方案，出问题搜教程少
适合：非 GKI 老机型、需要 KPM 内核补丁

一句话结论：

第一次玩 Root / 手机内核低于 5.10 / 大量 Magisk 模块 → Magisk
GKI 2.0 新机型，追求最强隐藏、内核级权限 → KernelSU（SukiSU-Ultra）
老机型非 GKI、内核 3.18~5.4，想上内核级 Root → APatch（FolkPatch）

四、安装前的准备#

4.1安装驱动并下载Fastboot\adb工具#

前往一键安装安卓驱动-官网下载一键安装adb\fastboot驱动程序，并进行安装

前往SDK 平台工具版本说明 | Android Studio | Android Developers下载适用于自己设备的工具

4.2 解锁 Bootloader#

这是唯一的硬门槛，三种方案都需要，且无法绕过。

解锁会清空手机全部数据
解锁后厂商保修基本作废
三星的 Knox 熔断是永久的，刷机也刷不回来：设置 → 关于手机 → Knox 保证位 会显示 0x1

各厂商解锁渠道：

品牌	方式
Google Pixel	`fastboot flash unlock`（`fastboot` 模式下音量下 + 电源，或 `adb reboot bootloader`）
小米 / 红米	目前已封死解锁渠道，部分机型可通过芯片后门解锁
一加 / 真我	音量下 + 电源进 fastboot，`fastboot flashing unlock`
三星	下载模式音量下 + 侧边键 → 屏幕提示 `Unlock` 长按
OPPO / vivo	需提交工单申请，审核通过后下解锁文件

4.3 完整备份#

解锁前把这些都备好，别指望解锁后还能取回：

照片、视频、聊天记录（微信/QQ 迁移）
各类 App 的本地数据（游戏存档、笔记、密码库）
双重验证器的导出种子/备份码

4.4 提取 stock 启动镜像（关键）#

这是新手最容易翻车的地方：Android 13 以后，大部分机型不再把 ramdisk 放在 boot.img，而是拆到了 init_boot.img。 补错了镜像轻则没 Root，重则变砖。

判断方法：

检查项	结论
机型发布时出厂系统于 Android 12 及更早	大概率是 `boot.img`
机型发布时出厂系统于 Android 13 及以后	大概率是 `init_boot.img`
解锁后手机型号变成 `a/b` 而不是 `a/b/c`	说明是 GKI 2.0 机型 → `init_boot.img`
用 Magisk 内置修补器时它自动选对了分区	直接用它的选择

提取方法一：全量包提取（推荐）

去手机厂商官网或可信的固件聚合站，下载完整线刷包（.zip / .ozip / .tgz），而不是手机里更新用的增量包。解包后找到 boot.img 或 init_boot.img。

提取方法二：自己 dump（需已Root）

手机开机后，打开adb调试，利用数据线连接到电脑上，在adb工具目录打开终端，输入下面命令

Terminal window

1
adb shell
2
su
3
# 查询当前激活槽位（a/b分区）
4
getprop ro.boot.slot_suffix
5
# 输出一般是 _a 或者 _b
6

7
# 例子：槽位是_a，则分区名 boot_a
8
dd if=/dev/block/boot_a of=/sdcard/boot.img
9
# 如果是init_boot机型
10
dd if=/dev/block/init_boot_a of=/sdcard/init_boot.img

执行完成后，手机内部存储根目录就有镜像，adb pull 拉到电脑

Terminal window

1
adb pull /sdcard/boot.img

⚠️ 坑：必须读取当前 active 槽位！读错槽位拿到旧系统镜像，修补后直接卡 fastboot

提取方法三：从卡刷包解 payload.bin

从卡刷包解压出payload.bin文件，利用柚坛工具箱提取boot.img 或 init_boot.img

五、Magisk 安装#

5.1 下载#

从官方 GitHub 下载：

1
https://github.com/topjohnwu/Magisk/releases

下载Magisk-v30.7.apk，app-debug.apk为调试版应用

5.2 修补镜像#

一般设备修补Boot镜像即可

Magisk App → 右上角 安装
选择 选择并修补一个文件
把 boot.img 或 init_boot.img 传到手机的根目录，选中它
等修补完成，输出文件在 Download/magisk_patched-30700-xxxxx.img
将修补后的文件传输到fastboot工具目录

5.3 刷入#

重启，开机时按住音量下+电源键进入Fastboot（线刷模式）

Terminal window

1
# 如果你修补的是 boot.img
2
fastboot flash boot magisk_patched-30700-xxxxx.img
3

4
# 如果你修补的是 init_boot.img
5
fastboot flash magisk_patched-30700-xxxxx.img
6

7
fastboot reboot

如果卡在 waiting for any device，可尝试更换数据线、USB口，如果还不行可重装驱动或重启电脑

5.4 验证#

开机后打开 Magisk，首页应显示已安装的版本号，而不是 N/A。如果还是 N/A，说明：

刷错了分区（该刷 init_boot 却刷了 boot）
或者刷的不是 stock 原版镜像

六、KernelSU 安装#

6.1 方式 A：修补 boot 镜像#

前提：你的机型是 GKI 2.0，内核版本在官方 .ko 覆盖范围内（5.10 / 5.15 / 6.1 / 6.6 / 6.12 / 6.18）。

下载 KernelSU_v3.3.0_32601-release.apk 并安装
打开软件，点击上方未安装(点击安装)选项卡 → 选择文件并修补 → 选择LKM：如有提示说明本机LKM，则按照提示选择；若无KMI提示，则选择与自己内核版本一致的；若无自己需要的LKM，可去酷安等权威社区下载适用自己机型的LKM(.ko)文件 → 输出文件在Download/kernelsu_patched-xxxxxxxx-xxxxxx.img
将修补后的镜像传输到电脑
进行与上文magisk一致的刷入镜像操作，并重启
重启后进入系统若管理器显示工作中，则Root完成

6.2 方式 B：使用GKI编译镜像#

此方法需要他人预编译好的GKI镜像，可从酷安等权威社区获取(谨慎辨别，小心格机)。因为是在内核中编译了kernelsu的静态代码，所以隐藏效果最好。

旧机型(5.10一下)仅能通过此方法使用kernelsu及其分支进行root操作

刷入GKI镜像与上文一致，不过仅需刷boot镜像

七、APatch 安装#

apatch的安装是这三个管理器最需要谨慎对待的

从官方下载 APatch_11224_*.apk 并安装
打开并选择需要修补的文件
选择性设定超级密钥
开始修补
输出文件为Download/apatch_patched-11224-xxxxxx_xxxx.img
刷入修补后的镜像，与上文刷入步骤一致

⚠️ APatch 的 SuperKey 注意事项：

忘记 SuperKey = 失去 Root，且无法通过任何官方途径找回
建议存在密码管理器里，不要记在脑子里
不要用生日、连输次数这种弱密码，它是解 Root 锁的唯一凭据

APatch 特有优势： 支持 KPM（Kernel Patch Module） 内核级代码注入，隐藏性优良，这是 Magisk 和 KernelSU 都做不到的。同时兼容 Magisk 格式模块（APM）。

八、救砖：卡在开机画面怎么办#

极有可能是你刷错了镜像，刷回修补前的镜像即可

Root 后变砖绝大多数不是 Magisk/KernelSU 本身的问题，是模块的问题。

安卓自带安全模式，会禁用所有第三方模块，不删除任何数据。

卡在开机 logo 时，长按电源键重启
开机震动 / 出现品牌 logo 瞬间，长按音量减，保持按住直到进入系统，屏幕左下角出现【安全模式】字样
进入系统后，打开 Magisk/KSU，卸载最近安装、导致卡开机的模块，重启退出安全模式

部分机型安全模式触发逻辑不一样：长按电源菜单里的重启按钮，弹出安全模式选项。

九、OTA 更新怎么处理#

OTA更新前关闭所有模块，刷回原版镜像后进行OTA更新。更新完成后重新提取镜像进行修补，刷入镜像即可。

十一、必须知道的四件事#

1. Root 不是「免费性能提升」#

绝大多数 Root 方案对日常流畅度没有正向帮助，反而有轻微性能开销（守护进程、模块加载）。Root 的价值在于：去广告、改系统行为、装扩展框架、备份还原、应用逆向调试。别为了「更快」去 Root。

2. Root 扩大了攻击面#

Root 之后，恶意 App 拿到 root 权限的门槛大幅降低。装 Root 后不要装来路不明的 APK，「Root 过的手机」本身就是高价目标。

3. 别信任何「免解锁 Root」工具#

市面上宣称「不解锁、不清数据、不触发熔断」的工具，要么只提供重启即失效的临时 Root，要么就是钓鱼软件下 malware。真正免解锁的临时 Root 在锁 Bootloader 的设备上做不到持久化——重启就没了。

4. 银行 App 与 Root 的兼容是长期博弈#

今天能用不代表明天能用。最稳的做法是：日常机不 Root，专门刷一台备用机做 Root 实验，或者用双系统/独立用户空间隔离。别把主力机的支付功能押在社区模块的更新速度上。

十二、分支#

这些管理器都有部分分支，分支拥有独特的UI或者功能。

其中kernelsu有KernelSU Next SukiSUUltra、ReSukiSU。

APatch有FolkPatch

总结#

你的情况	选什么	走哪条安装路径
第一次 Root / 想用 LSPosed	Magisk	内置修补器 patch `init_boot` → fastboot 刷入
银行 App 刚需 + 机型有 `.ko`	KernelSU	官方预编译 LKM 打进内核
刷了带 KSU 的第三方 ROM	KernelSU	Manager 直接装
前两者都不行、你是进阶用户	APatch	patch 内核，牢记superkey
只是想让 App 少点广告	试试 NewPipe / 无广告前端	不用 Root

行动顺序永远是：1.备份 → 2.解锁 → 3.提取并保存 stock 镜像 → 4.修补 → 5.刷入 → 6.验证

跳过第 1、3 步，后面任何一步失败都会让你失去退路。

—本文使用AI进行润色和信息补充，若有错误请指出—

为Firefly博客加入「更新日志」页面，记录并展示每一次的Git提交修改

Sat, 29 Aug 2026 00:00:00 GMT

前言#

闲的没事用AI搓出来的，有BUG可以在评论指出

功能说明#

新增一个 /changelog/ 页面，自动读取 git 提交历史并渲染成更新日志：

按日期倒序分组
提交按 Conventional Commits 前缀自动分类并上色（后文有详细说明）
默认展开最近 10 天，更早的自动折叠为 <details> 可展开
每次 pnpm build 自动刷新数据

涉及文件#

文件	说明
`scripts/generate-changelog.mjs`	生成数据脚本（读 git log → 写 `src/constants/changelog.json`）
`src/pages/changelog.astro`	更新日志页面本体
`src/constants/changelog.json`	数据文件（脚本自动生成）
`src/config/siteConfig.ts`	加页面开关
`src/types/siteConfig.ts`	加类型定义
`src/config/navBarConfig.ts`	导航栏加入口
`package.json`	build 脚本开头接入生成步骤

添加步骤#

放入生成脚本#

在你的博客/scripts中新建文件generate-changelog.mjs并输入下列内容

1
/**
2
 * 更新日志数据生成脚本
3
 * 读取 git 提交历史，按日期倒序分组，输出到 src/constants/changelog.json
4
 * 页面 src/pages/changelog.astro 读取渲染
5
 *
6
 * 用法：node scripts/generate-changelog.mjs
7
 */
8
import { spawnSync } from "node:child_process";
9
import { writeFileSync, mkdirSync } from "node:fs";
10
import { join, dirname } from "node:path";
11
import { fileURLToPath } from "node:url";
12

13
const __dirname = dirname(fileURLToPath(import.meta.url));
14
const ROOT_DIR = join(__dirname, "..");
15
const OUTPUT_FILE = join(ROOT_DIR, "src", "constants", "changelog.json");
16

17
// 提交类型 → 中文标签（Conventional Commits 前缀）
18
const TYPE_LABELS = {
19
    feat: "新功能",
20
    fix: "修复",
21
    perf: "优化",
22
    docs: "文档",
23
    refactor: "重构",
24
    style: "样式",
25
    test: "测试",
26
    build: "构建",
27
    ci: "CI",
28
    chore: "杂项",
29
    revert: "回退",
30
    merge: "合并",
31
    update: "更新",
32
    improve: "改进",
33
};
34

35
function detectType(subject) {
36
    const m = subject.match(/^([a-z]+)(\([^)]*\))?[:：]/);
37
    if (m && TYPE_LABELS[m[1]]) return m[1];
38
    return "other";
39
}
40

41
// 拉深历史（应对 CF Pages / CI 浅克隆 depth=1），失败忽略
42
spawnSync("git", ["fetch", "--unshallow"], {
43
    cwd: ROOT_DIR,
44
    stdio: "ignore",
45
});
46

47
console.log("读取 git 提交历史...");
48
const r = spawnSync("git", ["log", "--pretty=format:%h|%aI|%an|%s"], {
49
    cwd: ROOT_DIR,
50
    encoding: "utf8",
51
    maxBuffer: 64 * 1024 * 1024,
52
});
53

54
// 容错：git 不可用（浅克隆 / 无 git 环境 / CI 限制）时生成空数据，不中断构建
55
if (r.status !== 0) {
56
    console.warn(
57
        "[changelog] 警告: git log 执行失败（可能是浅克隆或无 git 环境），生成空数据。",
58
    );
59
    const empty = {
60
        generatedAt: new Date().toISOString(),
61
        total: 0,
62
        groups: [],
63
    };
64
    mkdirSync(dirname(OUTPUT_FILE), { recursive: true });
65
    writeFileSync(OUTPUT_FILE, JSON.stringify(empty, null, 2));
66
    console.log(`✅ 已生成空数据 ${OUTPUT_FILE}（total: 0）`);
67
    process.exit(0);
68
}
69
const log = r.stdout;
70

71
const groups = {};
72
const lines = log.split("\n").filter(Boolean);
73
for (const line of lines) {
74
    const [hash, isoDate, author, subject] = line.split("|");
75
    if (!hash || !isoDate) continue;
76
    const date = isoDate.slice(0, 10);
77
    const type = detectType(subject);
78
    (groups[date] ??= []).push({
79
        hash,
80
        date,
81
        time: isoDate.slice(11, 19),
82
        author,
83
        subject,
84
        type,
85
    });
86
}
87

88
const data = {
89
    generatedAt: new Date().toISOString(),
90
    total: lines.length,
91
    groups: Object.entries(groups)
92
        .map(([date, commits]) => ({ date, commits }))
93
        .sort((a, b) => b.date.localeCompare(a.date)),
94
};
95

96
mkdirSync(dirname(OUTPUT_FILE), { recursive: true });
97
writeFileSync(OUTPUT_FILE, JSON.stringify(data, null, 2));
98
console.log(`✅ 已生成 ${OUTPUT_FILE}`);
99
console.log(`   共 ${data.total} 次提交，${data.groups.length} 个日期分组`);

展开收起

添加页面#

在你的博客/src/pages中新建changelog.astro并输入下列内容：

1
---
2
import { siteConfig } from "@/config/siteConfig";
3
import MainGridLayout from "@/layouts/MainGridLayout.astro";
4
import changelog from "@/constants/changelog.json";
5

6
// 检查页面是否启用
7
if (!siteConfig.pages.changelog) {
8
  return Astro.redirect("/404/");
9
}
10

11
interface Commit {
12
  hash: string;
13
  date: string;
14
  time: string;
15
  author: string;
16
  subject: string;
17
  type: string;
18
}
19

20
// 提交类型 → 中文标签 + 语义色（与 scripts/generate-changelog.mjs 一致）
21
const TYPE_META: Record<string, { label: string; color: string }> = {
22
  feat: { label: "新功能", color: "#22c55e" },
23
  fix: { label: "修复", color: "#ef4444" },
24
  perf: { label: "优化", color: "#3b82f6" },
25
  docs: { label: "文档", color: "#8b5cf6" },
26
  refactor: { label: "重构", color: "#f59e0b" },
27
  style: { label: "样式", color: "#14b8a6" },
28
  test: { label: "测试", color: "#a855f7" },
29
  build: { label: "构建", color: "#64748b" },
30
  ci: { label: "CI", color: "#64748b" },
31
  chore: { label: "杂项", color: "#64748b" },
32
  revert: { label: "回退", color: "#ef4444" },
33
  merge: { label: "合并", color: "#06b6d4" },
34
  update: { label: "更新", color: "#0ea5e9" },
35
  improve: { label: "改进", color: "#10b981" },
36
  other: { label: "提交", color: "#94a3b8" },
37
};
38

39
const groups = changelog.groups as { date: string; commits: Commit[] }[];
40
const EXPANDED_COUNT = 10; // 默认展开最近 10 组
41
const generatedDate = changelog.generatedAt
42
  ? new Date(changelog.generatedAt).toLocaleDateString("zh-CN")
43
  : "";
44
---
45

46
<MainGridLayout title="更新日志">
47
  <div
48
    class="flex w-full rounded-(--radius-large) overflow-hidden relative min-h-32"
49
  >
50
    <div class="card-base z-10 px-9 py-6 relative w-full">
51
      <!-- 页面标题 -->
52
      <div class="flex flex-col items-start justify-center mb-8">
53
        <h1
54
          class="text-4xl font-bold text-black/90 dark:text-white/90 mb-2 relative before:w-1 before:h-8 before:rounded-md before:bg-(--primary) before:absolute before:top-1/2 before:-translate-y-1/2 before:-left-4"
55
        >
56
          更新日志
57
        </h1>
58
        <p class="text-sm text-black/60 dark:text-white/60">
59
          共 {changelog.total} 次提交 · {groups.length} 个日期
60
          {generatedDate && <>· 数据更新于 {generatedDate}</>}
61
        </p>
62
      </div>
63

64
      <!-- 提交列表 -->
65
      <div class="flex flex-col gap-4">
66
        {
67
          groups.map((group, gi) => (
68
            group.commits.length > 0 && (
69
              gi < EXPANDED_COUNT ? (
70
                // 展开的分组
71
                <div class="changelog-group">
72
                  <div class="changelog-date-row">
73
                    <span class="changelog-date-badge">{group.date}</span>
74
                    <span class="changelog-date-count">{group.commits.length} 条提交</span>
75
                  </div>
76
                  <div class="changelog-list">
77
                    {
78
                      group.commits.map((c) => (
79
                        <div class="changelog-item">
80
                          <span
81
                            class="changelog-type"
82
                            style={`color: ${TYPE_META[c.type]?.color ?? "#94a3b8"}; background: color-mix(in srgb, ${TYPE_META[c.type]?.color ?? "#94a3b8"} 12%, transparent);`}
83
                          >
84
                            {TYPE_META[c.type]?.label ?? "提交"}
85
                          </span>
86
                          <span class="changelog-subject">{c.subject}</span>
87
                          <span class="changelog-meta">
88
                            <span class="changelog-hash">{c.hash}</span>
89
                            <span class="changelog-time">{c.time}</span>
90
                          </span>
91
                        </div>
92
                      ))
93
                    }
94
                  </div>
95
                </div>
96
              ) : (
97
                // 折叠的旧分组
98
                <details class="changelog-collapse">
99
                  <summary class="changelog-collapse-summary">
100
                    <span class="inline-flex items-center gap-2 text-sm text-(--content-meta) cursor-pointer select-none">
101
                      <span class="changelog-collapse-icon">▸</span>
102
                      <span class="font-medium">{group.date}</span>
103
                      <span class="text-xs opacity-70">（{group.commits.length} 条提交）</span>
104
                    </span>
105
                  </summary>
106
                  <div class="changelog-collapse-body">
107
                    <div class="changelog-group mt-2">
108
                      <div class="changelog-list">
109
                        {
110
                          group.commits.map((c) => (
111
                            <div class="changelog-item">
112
                              <span
113
                                class="changelog-type"
114
                                style={`color: ${TYPE_META[c.type]?.color ?? "#94a3b8"}; background: color-mix(in srgb, ${TYPE_META[c.type]?.color ?? "#94a3b8"} 12%, transparent);`}
115
                              >
116
                                {TYPE_META[c.type]?.label ?? "提交"}
117
                              </span>
118
                              <span class="changelog-subject">{c.subject}</span>
119
                              <span class="changelog-meta">
120
                                <span class="changelog-hash">{c.hash}</span>
121
                                <span class="changelog-time">{c.time}</span>
122
                              </span>
123
                            </div>
124
                          ))
125
                        }
126
                      </div>
127
                    </div>
128
                  </div>
129
                </details>
130
              )
131
            )
132
          ))
133
        }
134
      </div>
135

136
      <!-- 页脚说明 -->
137
      <p class="text-xs text-(--content-meta) mt-8 pt-4 border-t border-(--line-divider)">
138
        数据由 <code class="text-(--primary)">scripts/generate-changelog.mjs</code> 在构建时从 git 提交历史自动生成。
139
      </p>
140
    </div>
141
  </div>
142
</MainGridLayout>
143

144
<style>
145
  /* 日期分组 */
146
  .changelog-group {
147
    display: flex;
148
    flex-direction: column;
149
    gap: 0.5rem;
150
  }
151

152
  .changelog-date-row {
153
    display: flex;
154
    align-items: center;
155
    gap: 0.75rem;
156
    margin-bottom: 0.25rem;
157
  }
158

159
  .changelog-date-badge {
160
    display: inline-flex;
161
    align-items: center;
162
    padding: 0.2rem 0.75rem;
163
    border-radius: 9999px;
164
    font-size: 0.8rem;
165
    font-weight: 600;
166
    font-variant-numeric: tabular-nums;
167
    color: var(--primary);
168
    background: color-mix(in oklch, var(--primary) 12%, transparent);
169
    border: 1px solid color-mix(in oklch, var(--primary) 25%, transparent);
170
  }
171

172
  .changelog-date-count {
173
    font-size: 0.75rem;
174
    color: var(--content-meta);
175
  }
176

177
  /* 提交列表 */
178
  .changelog-list {
179
    display: flex;
180
    flex-direction: column;
181
    border: 1px solid var(--line-divider);
182
    border-radius: 0.75rem;
183
    overflow: hidden;
184
  }
185

186
  .changelog-item {
187
    display: flex;
188
    align-items: center;
189
    gap: 0.75rem;
190
    padding: 0.55rem 0.9rem;
191
    font-size: 0.85rem;
192
    transition: background 0.2s ease;
193
  }
194

195
  .changelog-item:not(:last-child) {
196
    border-bottom: 1px dashed var(--line-divider);
197
  }
198

199
  .changelog-item:hover {
200
    background: var(--btn-plain-bg-hover);
201
  }
202

203
  .changelog-type {
204
    flex-shrink: 0;
205
    display: inline-flex;
206
    align-items: center;
207
    padding: 0.1rem 0.5rem;
208
    border-radius: 0.4rem;
209
    font-size: 0.7rem;
210
    font-weight: 600;
211
    white-space: nowrap;
212
  }
213

214
  .changelog-subject {
215
    flex: 1;
216
    min-width: 0;
217
    font-weight: 500;
218
    color: var(--deep-text);
219
    overflow: hidden;
220
    text-overflow: ellipsis;
221
    white-space: nowrap;
222
  }
223

224
  .changelog-meta {
225
    flex-shrink: 0;
226
    display: inline-flex;
227
    align-items: center;
228
    gap: 0.5rem;
229
    font-size: 0.7rem;
230
    font-variant-numeric: tabular-nums;
231
  }
232

233
  .changelog-hash {
234
    font-family: ui-monospace, "Cascadia Mono", "Segoe UI Mono", monospace;
235
    color: var(--primary);
236
    opacity: 0.75;
237
  }
238

239
  .changelog-time {
240
    color: var(--content-meta);
241
  }
242

243
  /* 折叠分组 */
244
  .changelog-collapse {
245
    border: 1px solid var(--line-divider);
246
    border-radius: 0.75rem;
247
    overflow: hidden;
248
  }
249

250
  .changelog-collapse-summary {
251
    list-style: none;
252
    padding: 0.6rem 0.9rem;
253
    cursor: pointer;
254
    transition: background 0.2s ease;
255
  }
256

257
  .changelog-collapse-summary:hover {
258
    background: var(--btn-plain-bg-hover);
259
  }
260

261
  .changelog-collapse-summary::-webkit-details-marker {
262
    display: none;
263
  }
264

265
  .changelog-collapse[open] .changelog-collapse-icon {
266
    transform: rotate(90deg);
267
  }
268

269
  .changelog-collapse-icon {
270
    display: inline-block;
271
    transition: transform 0.2s ease;
272
    font-size: 0.7rem;
273
  }
274

275
  .changelog-collapse-body {
276
    padding: 0 0.75rem 0.75rem;
277
  }
278

279
  /* 暗色适配 */
280
  :global(.dark) .changelog-subject {
281
    color: rgba(255, 255, 255, 0.88);
282
  }
283
</style>

展开收起

注册页面#

打开 src/config/siteConfig.ts，在 pages 页面开关配置（resolvePageToggles({ ... }) 内）添加：

1
  // 更新日志页面开关（自定义页面）
2
  changelog: true,

打开 src/types/siteConfig.ts，在 pages 类型定义pages: { ... };中添加：

1
  changelog?: boolean; // 更新日志页面开关（用户自定义）

添加导航栏入口#

打开 src/config/navBarConfig.ts：

① 在 LinkPresets 对象末尾（About 之后）添加：

1
  // 更新日志（自定义页面）
2
  Changelog: {
3
    name: "更新日志",
4
    url: "/changelog/",
5
    icon: "material-symbols:history",
6
    pageKey: "changelog",
7
  },

② 在「关于」菜单的 children 数组中添加（顶部）：

1
  children: [
2
    // 更新日志
3
    LinkPresets.Changelog,
4

5
    // 打赏
6
    LinkPresets.Sponsor,
7

8
    // 关于页面
9
    LinkPresets.About,
10
  ],

接入构建流程（可选但推荐）#

打开 package.json，在 build 最前面加上生成步骤：

1
"build": "node scripts/generate-changelog.mjs && npx tsx scripts/generate-github-card-data.ts && ..."

首次生成数据#

博客根目录执行：

Terminal window

1
node scripts/generate-changelog.mjs

会在 src/constants/changelog.json 生成数据（显示「共 N 次提交 · M 个日期」）。

使用说明#

提交规范：

提交消息以类型前缀开头即可自动分类

示例：

Terminal window

1
git commit -m "feat: 新增音乐可视化"
2
git commit -m "fix: 修复天气按钮重叠"
3
git commit -m "perf: 压缩文章图片"

提交前缀	页面显示	颜色	适用场景
`feat:`	新功能	绿	新页面、新组件、新能力
`fix:`	修复	红	修 bug、修样式问题
`perf:`	优化	蓝	性能、加载速度
`improve:`	改进	青	体验改进（非性能）
`refactor:`	重构	橙	重写代码，行为不变
`style:`	样式	青蓝	纯 CSS/视觉调整
`docs:`	文档	紫	README、注释、文档
`chore:`	杂项	灰	依赖、配置、杂物
`build:`	构建	灰	构建脚本/流程
`merge:`	合并	浅青	分支合并
`revert:`	回退	红	撤销提交
其他	提交	灰	未匹配的默认分类
每次提交都需执行`node scripts/generate-changelog.mjs`更新日志数据

若接入构建流程可由平台部署时自动生成

完整工作流：

Terminal window

1
# 1. 提交你的改动
2
git add .
3
git commit -m "feat: xxx"
4

5
# 2. 刷新更新日志数据（或直接 pnpm build 自动刷新）
6
node scripts/generate-changelog.mjs
7

8
# 3. 提交更新后的数据
9
git add src/constants/changelog.json
10
git commit -m "chore: 更新更新日志"
11

12
git push

注意事项#

脚本读的是当前 git 仓库历史——如果仓库带有上游历史（比如从模板复制），日志会显示上游的提交；想只显示自己的提交，请先重置历史：删除 .git 后 git init + 首次提交。
Cloudflare Pages / Workers 部署：CF 默认浅克隆（depth=1），脚本开头会自动 git fetch --unshallow 拉深历史——只要部署平台执行 pnpm build（build 脚本含 generate-changelog），就能在构建时生成最新提交数据，无需本地手动跑。git 环境不可用时会生成空数据（页面显示 0 条），不会导致构建失败。
页面默认展开最近 10 组，如需调整改 changelog.astro 顶部的 EXPANDED_COUNT 常量。
如需修改分类文案/颜色，同时改脚本 TYPE_LABELS 和页面 TYPE_META（两处保持一致）。

Cloudflare国内速度优化、优选域名IP心得分享

Wed, 26 Aug 2026 00:00:00 GMT

前言#

最近发现自己的网站部署在Cloudflare Workers上，不开代理访问速度很慢，去ITDOG测试了才发现原来我的网站在国内访问速度惨不忍睹，加载时间最长甚至需要20s。

于是我开始寻找解决方案，经过一段时间的寻找，最终也是发现了IP优选这条方法。

Cloudflare的CDN在全球有不少的边缘节点，访问距离自己距离近的节点能够显著提升访问速度。但是CF通常分配的IP段都距离国内很远，于是访问延迟一下子上去了。这时就需要优选域名/IP了。

优选域名/IP的原理是跳过CF的CDN调度，直接指定一个优质CF边缘IP。而优选域名的本质就是别人帮你24小时测速选择一批优质IP。

对于Wokers&Pages项目有效，R2存储库、SaaS项目也可以加速但本文不过多阐述

无优选

优选域名

优选IP

加速步骤#

优选域名（推荐）#

优选域名是使用别人维护的CNAME解析，自动帮助解析优质IP

下面是一些长期较稳定的优选域名：

前往你的Workers&Pages项目-域，点击添加路由，并选择你的域名，并修改编辑框内容

接着前往你域名的DNS解析处，新建解析，类型CNAME，名称填你刚才路由里填写的域名，目标填写你的优选域名，接着关闭小黄云，点击保存

至此优选域名加速已经生效了。

优选IP#

优选IP则是需要我们手动查看哪个IP优质了

这里我们使用一个GitHub上的工具自选优选 IP 。下载对应的客户端并打开，工具会自动测试哪个IP段国内速度更优，等待一会后会出现一个列表，选择延迟最低的即可。

参考上方优选域名的操作，将CNAME改成A，接着填入测出来的IP即可。

此方案缺点：需要定时手动测速。

小结#

加速后的访问速度明显比加速前快多了，希望这篇文章能帮到你。

MoePal-一款多平台的综合网盘管理、加速下载工具

Thu, 13 Aug 2026 00:00:00 GMT

简介#

MoePal官网

我们都有不少的数据存储在各大网盘上，有时候想寻找、管理网盘数据的时候发现太过麻烦，还得下载打开登录各大网盘的客户端，麻烦且不说还非常臃肿。

MoePal是一种非常好的解决方案，它支持登录管理10+网盘的数据，仅需一个客户端就可以将自己的云盘握在手中。

MoePal还有一个非常实用的功能：下载加速。例如夸克云盘即使开了会员它最高下载速度为50MB，而moepal能给你干到70MB。

不过只有部分网盘（夸克、123网盘,光鸭，蓝奏云）目前支持免费使用，如果想要解锁全部云盘需要购买卡密。目前卡密价格适中（我能接受🤔），年卡58，月卡13，周卡6。

[TIP] 提醒此工具主要功能为更方便的管理网盘、下载文件，无法绕过部分网盘的下载流量限制。

安装使用#

安卓端下载APK安装登录即可使用

Macos按照正常流程拖入应用程序打开登录即可使用

这里以Windows端安装和登录为示例

下载并安装.exe安装包

这里就安装完成了，点击完成即可打开软件使用↓

使用#

这里以Windows端使用为示例，其余设备使用逻辑相同

点击左下角登录输入你的账户密码登录（没有账户密码的可以选择注册）然后就是基本使用方法了

下载速度展示（夸克云盘）

提升下载速度方法：

设置线路为快传，线程设置的大一些

其他网盘想要下载速度快一些的话就把线程设置大一些，这样可以加速下载。

利用自己的域名+Cloudflare+Resend搭建属于自己的域名邮箱，实现零成本收发邮件功能

Mon, 10 Aug 2026 00:00:00 GMT

1.前言#

当你买了自己的第一个域名后，看到xxx@163.com、xxx@gmail.com、xxx@outlook.com这些邮箱，是否想把@后面换成自己的域名？

我猜你肯定很想，本文就是利用Cloudflare+Resend实现自己的域名邮箱也能收发邮件

不过在开始之前，你需要有下列东西：

自己的域名，并解析到Cloudflare如果没有的话还是先去买一个吧？
一个能正常使用的邮箱
良好的网络环境

2.原理#

接收邮件#

在Cloudflare中利用Cloudflare的邮箱路由规则，在DNS中添加CF的MX解析后，所有发到你域名邮箱的邮件会转发到你设置的可用邮箱

邮件

你的域名邮箱

Cloudflare

自己的邮箱

邮件

你的域名邮箱

Cloudflare

自己的邮箱

发送邮件#

在Resend中绑定自己的域名，并解析DNS，利用resend提供的SMTP服务实现发送邮件

SMTP发送邮件

Resend服务

目标邮箱

SMTP发送邮件

Resend服务

目标邮箱

3.操作步骤#

3.1接收邮件#

登录Cloudflare，来到你的域名的页面，并打开左侧栏中电子邮件-电子邮件路由选项

接着打开设置选项，点击下方添加缺失记录按钮

然后点击路由规则选项，点击右侧创建路由规则

按照下图填写，填写完毕后点击保存

保存完毕后，查看你正在使用的邮箱，稍等片刻，你可以看到一封Cloudflare发来的验证邮件，点击Verify email address按钮，验证你上步填写的邮箱是否可用返回到邮件路由-路由规则，配置正常的话应该为下图所示接着你可以用其他邮箱（或者刚才填写的邮箱）向你配置的域名邮箱（例如我的是test@jerry-nis.top）发送邮件测试

至此你可以用你的域名邮箱接收短信了，非常的有逼格。

3.2发送邮件#

打开Resend,注册一个账号（推荐使用邮箱注册）注册完成后，来到控制台，点击左侧侧边栏的Domains选项卡，并点击右侧的Add domain按钮

按照下图填写接着会提示需要配置DNS，由于我们使用的是cloudflare，所以我们直接点击Auto configure

接着会弹出Cloudflare授权，我们点击授权按钮即可页面会回到Resend控制台，配置正常应该会显示如下接着点击左侧侧边栏的API keys，并点击右侧的Create API keys，在弹出的窗口中填写名称并点击Add创建创建后会给你一串密钥，务必保存好，因为这是SMTP服务的密码

3.2.1功能验证与使用#

前往SMTP测试工具测试邮件发送

SMTP客户端配置

服务器：smtp.resend.com
端口：465
账户：resend
密码：API 密钥

使用：沿用 Gmail 客户端配置模式，将发送邮件的 SMTP 服务配置改为 Resend 的配置参数。

更多示例参考官方帮助文档

小结#

至此，你可以利用你的域名邮箱接收邮件；也可以利用SMTP服务发送邮件了，自定义程度极高。

Git 推送被拒与合并冲突解决方案

Sun, 02 Aug 2026 00:00:00 GMT

这篇教程把 “推送被拒” 和 “合并冲突” 这两类最让新手崩溃的 Git 问题拆成可照做的步骤。每个场景都给出 报错原文 → 原因 → 解决命令，并附一张决策图帮你快速定位。建议先看第 1 节理解原理，遇到具体报错直接跳到对应场景。

原理：为什么会拒绝推送#

Git 是一个分布式版本控制系统，本地仓库和远程仓库各自维护一串提交（commit）历史。当你执行 git push 时，Git 会把本地的新提交追加到远程分支的末尾。但这个”追加”有一个硬性前提：远程分支的当前提交，必须是你本地历史的直接祖先。

如果在你提交期间，别人已经往远程推了新提交，远程分支就”往前走”了。这时你的本地历史和远程历史就出现了分叉（divergence）——本地有远程没有的提交，远程也有本地没有的提交。Git 为了不丢弃任何人的工作，会拒绝你的推送，这就叫 non-fast-forward。

mainfeatureABC 你的提交D 同事的提交E 同事的提交

图 1：main 与 feature 分叉——你的 C 提交与远程的 D、E 互不包含，直接 push 必然 non-fast-forward。

所谓 fast-forward（快进），就是远程分支没有任何新提交，Git 只需把分支指针从 B 直接挪到 C，历史是一条直线，没有任何风险。一旦分叉，就只能通过 merge（合并） 或 rebase（变基） 把两条线重新整合成一条，然后才能推送。

💡 一句话记住：推送被拒 ≠ 代码有 bug，而是 Git 在说：“远程变了，请你先把别人的改动整合进来再推。” 拒绝推送是 Git 的保护机制，不是错误。

报错速查表：对号入座#

先看报错里出现的关键词，对照下表跳到对应章节。这是整篇教程的”急诊分诊台”。

报错关键词	含义	根因	跳转
`non-fast-forward`	无法快进推送	远程已有你本地没有的新提交	§3
`fetch first`	请先拉取	同上，Git 提示你先 fetch	§4
`Permission denied` / `403`	权限被拒	认证失败、无写权限、HTTPS 凭据错误	§5
`protected branch` / `cannot force`	分支受保护	平台规则禁止直推/强推	§6
`! [rejected] (fetch first)` 且用了 rebase	变基后强推被拦	需要 force 但用了普通 push	§7
`pre-receive hook declined`	服务端钩子拒绝	大文件、提交信息规范、CI 校验未过	§8
`CONFLICT (content)`	合并冲突	同一文件同一处被双方都改了	§9

non-fast-forward / fetch first

Permission denied / 403

protected / cannot force

pre-receive declined

是

否

git push 被拒

报错关键词?

远程有新提交

认证或权限

分支保护

服务端钩子

fetch + merge 或 pull --rebase

检查凭据 / 换 SSH / 加权限

走 PR 或临时关闭保护

看钩子日志修问题

是否产生 CONFLICT?

解决冲突 §9/§10

重新 push ✓

non-fast-forward / fetch first

Permission denied / 403

protected / cannot force

pre-receive declined

是

否

git push 被拒

报错关键词?

远程有新提交

认证或权限

分支保护

服务端钩子

fetch + merge 或 pull --rebase

检查凭据 / 换 SSH / 加权限

走 PR 或临时关闭保护

看钩子日志修问题

是否产生 CONFLICT?

解决冲突 §9/§10

重新 push ✓

图 2：推送被拒决策树——按报错分支处理，绝大多数情况落在左侧路径。

non-fast-forward：远程已有新提交#

这是最高频的推送被拒场景。典型报错长这样：

1
! [rejected]        main -> main (non-fast-forward)
2
error: failed to push some refs to 'github.com:you/repo.git'
3
hint: Updates were rejected because the tip of your current branch is behind
4
hint: its remote counterpart. Integrate the remote changes (e.g.
5
hint: 'git pull ...') before pushing again.

解决思路只有两条路：合并（merge） 或 变基（rebase）。两者都会把远程的新提交整合进本地，区别在于历史长什么样。

方案 A：merge 合并（最稳妥，推荐新手）#

把远程改动拉下来并与本地合并，产生一个合并提交（merge commit），历史保留分叉再汇合的形状。

Terminal window

1
# 1. 拉取远程并自动合并（= fetch + merge）
2
git pull origin main
3

4
# 2. 如有冲突，解决后继续（见 §9）
5
# 3. 解决完，重新推送
6
git push origin main

方案 B：rebase 变基（历史更线性，推荐进阶）#

把你的本地提交”摘下来”，放到远程最新提交的后面，历史变成一条直线，没有合并提交。

Terminal window

1
# 拉取并以 rebase 方式整合（推荐）
2
git pull --rebase origin main
3

4
# 如有冲突，逐个解决后继续（见 §10）
5
git rebase --continue
6

7
# 整合完成后推送
8
git push origin main

💡 怎么选：团队协作、共享分支（如 main）优先 pull --rebase，历史干净；个人特性分支或怕麻烦就用 git pull（默认 merge）。想一劳永逸，看 §12 把 rebase 设为默认。

⚠️ 千万别这么做：报错后直接 git push -f 强推覆盖远程——这会永久丢弃同事已经推送的提交，是协作中的大忌。除非你 100% 确定远程那些提交该删，否则永远先整合再推。

fetch first：本质同源的提示#

有时报错不是 non-fast-forward，而是更”客气”的 fetch first：

1
! [rejected]        main -> main (fetch first)
2
error: failed to push some refs to 'github.com:you/repo.git'

这跟上一节是同一回事，只是 Git 给出的措辞不同——它直接告诉你”先 fetch 一下”。本质都是远程领先于本地。解决方法完全相同：

Terminal window

1
# 二选一
2
git pull --rebase origin main   # 线性历史
3
git pull origin main             # 产生合并提交
4
git push origin main

⚠️ 区分 fetch 与 pull：git fetch 只下载远程更新到本地的远程跟踪分支（origin/main），不动你的工作区；git pull = fetch + merge，会直接改动工作区。想先看看远程改了啥再决定怎么整合，用 fetch 更安全。

Permission denied：权限或认证问题#

如果报错跟历史无关，而是认证/权限类，常见形式：

1
remote: Permission to you/repo.git denied to otheruser.
2
fatal: unable to access 'https://github.com/you/repo.git/':
3
The requested URL returned error: 403

常见原因与对策#

原因	现象	解决
HTTPS 密码填错 / 用了登录密码	反复提示输密码、403	GitHub 已不接受账号密码，需用 Personal Access Token 当密码
凭据缓存了旧账号	提示 denied to otheruser	清除凭据：Windows 用”凭据管理器”，或 `git credential-manager delete`
没有仓库写权限	403 / Permission denied	让仓库 owner 把你加为 Collaborator，或 fork 后提 PR
SSH 密钥未配置	Permission denied (publickey)	生成密钥并添加到平台：`ssh-keygen` → 复制公钥到 GitHub 设置
远程地址写错	推到别人的仓库被拒	`git remote -v` 检查，`git remote set-url origin <url>` 修正

切换到 SSH（推荐，避免反复输密码）#

Terminal window

1
# 查看当前远程地址
2
git remote -v
3

4
# 把 HTTPS 换成 SSH
5
git remote set-url origin git@github.com:you/repo.git

💡 验证 SSH 是否通：ssh -T git@github.com 返回 “Hi username! You’ve successfully authenticated” 即表示密钥配置成功。

protected branch：分支保护拦截#

GitHub、GitLab、Gitea 等平台支持对分支设置保护规则，禁止直接推送或强制推送，强制走 Pull Request。报错类似：

1
remote: error: GH006: Protected branch update failed for refs/heads/main.
2
remote: error: Cannot force-push to a protected branch.
3
remote: error: Changes must be made through a pull request.

正确做法：走 Pull Request#

新建分支并提交：别直接动 main，在特性分支上开发：git checkout -b feature/x → 提交 → git push -u origin feature/x
发起 Pull Request：在平台上从 feature 分支向 main 发起 PR，请求 review。
通过后合并：review 通过后在平台上点 Merge，或本地合并后推送（前提是你有合并权限）。

如果你是管理员，需要临时强推#

到仓库 Settings → Branches → Branch protection rules，临时关闭 “Require a pull request” 或 “Allow force pushes”，推完再开回来。务必推完立刻恢复保护规则。

⚠️ main 分支永远不要强推：即便你有权限，对 main/develop 这类共享分支强推会让所有人的本地仓库错乱。强推只该用在自己的特性分支上（见 §7）。

force push 被拒：改用 force-with-lease#

当你对已推送的提交做过 commit --amend、rebase 或 reset，本地提交的 hash 变了，普通 push 会因 non-fast-forward 被拒，这时确实需要强制推送。

但 永远不要用 git push -f，而要用更安全的 --force-with-lease：

Terminal window

1
# ❌ 危险：无条件覆盖，可能踩掉别人的提交
2
git push -f origin feature/x
3

4
# ✓ 安全：仅当远程没被别人更新时才覆盖
5
git push --force-with-lease origin feature/x

—force-with-lease 的保护机制#

它会在推送前检查：远程分支的当前指针，是否还停留在你上次 fetch 时记录的位置。如果有人在此期间推了新提交，强推会被拒绝——从而避免你无意中覆盖同事的工作。

💡 设个别名更省事：git config --global alias.pushf "push --force-with-lease"，以后 git pushf 即可安全强推。

⚠️ 强推的两条铁律：① 只在自己的特性分支上强推，绝不对共享分支强推；② 永远用 --force-with-lease 而非 -f。如果 lease 也被拒，说明远程真有新东西，老老实实 pull 整合。

大文件与 hook 拦截#

大文件导致推送失败#

GitHub 单文件限制 100MB，超过会直接拒绝：

1
remote: error: File large.zip is 134.5 MB; this exceeds GitHub's file size limit of 100.00 MB
2
remote: error: GH001: Large files detected.

Terminal window

1
# 方案 1：用 Git LFS 管理大文件
2
git lfs install
3
git lfs track "*.zip"
4
git add .gitattributes
5
git add large.zip
6
git commit -m "add large file via LFS"
7
git push
8

9
# 方案 2：若大文件已误提交，用 filter 从历史移除
10
git rm --cached large.zip
11
# 用 git filter-repo 彻底清除历史中的大文件

pre-receive / 服务端 hook 拒绝#

平台侧的钩子会校验提交信息格式、文件命名、是否通过 CI 等，不达标就 declined。这类报错必须按钩子给出的提示修——常见如提交信息不符合 Conventional Commits 规范、未关联 issue、代码未通过 lint。

⚠️ 误提交大文件后的陷阱：如果你已经 commit 了 100MB 文件，即便 git rm 删掉再提交，历史里那个大文件依然存在，push 还是会失败。必须用 git filter-repo 或 git rebase -i 把它从历史中彻底抹除，再强推。

合并冲突：完整解决流程#

当 git pull、git merge 或 git rebase 时，如果双方改动了同一文件的同一区域，Git 无法自动合并，就会暂停并报冲突。

冲突长什么样#

Git 会在冲突文件里插入冲突标记，把两边的代码都保留下来让你二选一或合并：

1
<<<<<<< HEAD
2
const title = "我的版本";      ← 你当前分支（HEAD）的改动
3
=======
4
const title = "同事的版本";    ← 进来的那一方的改动
5
>>>>>>> incoming-branch

三组标记的含义：

<<<<<<< HEAD 到 =======：你当前分支（HEAD）的内容
======= 到 >>>>>>>：进来的对方分支的内容
>>>>>>> 分支名：标记对方分支来源

解决步骤（merge 场景）#

查看哪些文件冲突：git status 会列出 “Unmerged paths” 下所有冲突文件，标 both modified。
打开冲突文件手动编辑：决定保留哪部分、丢弃哪部分，或把两边逻辑合并成新代码。删掉所有冲突标记（<<<、===、>>>），保留最终正确内容。
标记冲突已解决：git add <文件>（不是 commit，只是加入暂存区表示已解决）。
完成合并：git commit 生成合并提交（merge 场景），通常会自动弹出默认合并信息，保存退出即可。
继续推送：git push，这次就能成功了。

用工具解决更高效#

手动改容易漏删标记，推荐用可视化工具：VS Code 内置的 “Merge Editor”（点击冲突文件的 “Resolve in Merge Editor”）、JetBrains 系（IDEA/PyCharm）的三栏合并窗口、或命令行 git mergetool。

想放弃怎么办#

Terminal window

1
# merge 冲突想反悔，回到合并前状态
2
git merge --abort
3

4
# rebase 冲突想反悔
5
git rebase --abort
6

7
# 查看还没解决的冲突文件
8
git diff --name-only --diff-filter=U

💡 解决前先备份：冲突文件改坏了不好恢复，动手前先 cp file file.bak 或另开一个分支 git stash 当前状态，万一改崩了能回退。

rebase 冲突：continue / skip / abort#

rebase 冲突的处理流程跟 merge 略有不同。rebase 是把你本地的提交一个个重放到远程最新提交之上，每重放一个都可能撞上冲突，所以可能要解决多次。

rebase 冲突三连#

解决当前文件的冲突：同样删标记、编辑成最终内容，然后 git add <文件>。
继续重放下一个提交：git rebase --continue。注意：rebase 场景不要 commit，用 --continue 推进。若又遇冲突，重复步骤 1。
全部重放完成：提示 “Successfully rebased” 后，git push 即可（若之前已推过该分支，需 git push --force-with-lease）。

三个关键命令#

命令	作用	何时用
`git rebase --continue`	解决冲突后继续	改完、add 后推进
`git rebase --skip`	跳过当前提交	这个提交的改动已被远程包含、是空提交
`git rebase --abort`	放弃整个 rebase	改不下去了，回到 rebase 前状态

⚠️ rebase 中途别乱切分支：rebase 进行中工作区处于”游离”状态，此时 git checkout 切别的分支、git pull 都可能把状态搞乱。要么 --abort 退出，要么 --continue 走完，不要中途分心。

merge 还是 rebase：怎么选#

两种整合方式各有取舍，理解差异才能选对：

对比维度	merge 合并	rebase 变基
历史形状	保留分叉与汇合，真实记录	线性，像从未分叉过
合并提交	产生一个 merge commit	无，提交被重排
提交 hash	原提交不变	你的提交 hash 会改变
冲突解决	一次性解决全部	可能逐个提交多次解决
适用场景	共享分支、保留真实历史	个人特性分支、整理整洁历史
风险	低，不改写历史	已推送的分支 rebase 后需强推

黄金法则#

“不要 rebase 已经推送到公共分支、且他人在用的提交。” 因为 rebase 会改写 hash，别人 pull 下来会出现重复和混乱。自己的、没人依赖的特性分支随便 rebase；共享的 main/develop 老老实实 merge。

预防冲突的最佳实践#

冲突治标不如治本。下面这些习惯能让你少踩 90% 的坑：

勤拉取，小步提交。 每天开工先 git pull --rebase，频繁同步远程；别攒一大堆改动再推，分叉越大冲突越多。
把 rebase 设为 pull 默认。 git config --global pull.rebase true，以后 git pull 自动走 rebase，历史更干净。
特性分支短命。 一个分支活越久，与 main 分叉越严重。功能做完尽快合并，别让分支挂两周。
分工避免改同一处。 团队约定模块边界，减少多人同时改同一文件的概率。
开启 git rerere 自动复用解决方案。 git config --global rerere.enabled true，Git 会记住你解决过的冲突，下次遇到相同冲突自动套用。
提交前先 pull。 养成 commit → pull --rebase → push 的固定节奏，而不是 commit 完直接 push。
用 .gitignore 管好临时文件。 避免把本地配置、日志、构建产物提交，这些是冲突重灾区。

💡 rerere 是什么：“reuse recorded resolution”——重用已记录的解决方案。开启后，当你解决过一次某冲突，下次遇到完全相同的冲突块，Git 会自动按你上次的解决方式填好，连标记都不用删。在长期维护多个特性分支、反复 rebase 同一基准的工作流里特别省心。

命令速查表#

把这张表存下来，遇到问题直接查。这是全文命令的浓缩版。

场景	命令
拉取并合并（默认）	`git pull origin main`
拉取并变基（推荐）	`git pull --rebase origin main`
设 pull 默认走 rebase	`git config --global pull.rebase true`
只下载不动工作区	`git fetch origin`
查看冲突文件	`git status`
标记冲突已解决	`git add <文件>`
完成 merge 合并	`git commit`
rebase 继续推进	`git rebase --continue`
rebase 跳过当前提交	`git rebase --skip`
放弃 merge	`git merge --abort`
放弃 rebase	`git rebase --abort`
安全强推（务必用这个）	`git push --force-with-lease`
危险强推（勿用）	`git push -f`
查看远程地址	`git remote -v`
改远程地址为 SSH	`git remote set-url origin git@github.com:you/repo.git`
开启冲突复用	`git config --global rerere.enabled true`
管理大文件	`git lfs track "*.zip"`
验证 SSH	`ssh -T git@github.com`

💡 日常节奏口诀：开工先 pull，提交要小步；push 前再 pull，强推用 lease；冲突删标记，rebase 用 continue；共享分支只 merge，个人分支才 rebase。

参考资料#

Arch Linux安装以及使用指南

Thu, 30 Jul 2026 00:00:00 GMT

前言#

下文Arch Linux简称为”Arch”.

Arch 是一个极简单的Linux发行版，它安装好以后只有一个黑不拉几的命令行，对小白并不是很友好，但当我们配置完毕后他会成为一个强大的工具。

Arch的特性就是滚动更新和pacman包管理器，拥有这两者你能获得时刻都是最新的系统以及便利迅速的包安装体验。 Arch还拥有强大的社区资源以及详细丰富的Wiki文档，通过翻阅wiki你能快速了解掌握Arch的使用方法。

本文为Archlinux2026.07.01镜像、Vmware16虚拟机模拟安装，与实际情况近似，安装时请以实际情况为准。

什么？你怕这些命令会有错误？但是本文依据实际安装流程总结而得QwQ。

送给小白的部分注意事项：

nano编辑器Ctrl+O为保存输出文件，Ctrl+X为关闭编辑器
磁盘分区、格式化和挂载部分注意自己的数据

安装指南#

1.安装准备#

1.1下载安装镜像#

前往 Arch Linux 官方下载页面 archlinux.org/download，下载最新的 ISO 镜像文件（约 1 GB）。建议从国内镜像站下载以获得更快的速度：

镜像站	地址
清华大学 TUNA	`https://mirrors.tuna.tsinghua.edu.cn/archlinux/iso/latest/`
中科大 USTC	`https://mirrors.ustc.edu.cn/archlinux/iso/latest/`
上海交大 SJTUG	`https://mirror.sjtu.edu.cn/archlinux/iso/latest/`
华为云	`https://mirrors.huaweicloud.com/archlinux/iso/latest/`

1.2制作U盘启动盘#

Windows 系统#

提示

下方两种操作均会擦除/删除你U盘上的所有数据，请注意备份数据！

使用 Rufus 工具（免费开源）：

操作步骤

下载 Rufus 并运行
选择你的 U 盘设备
选择 Arch Linux ISO 文件
分区类型选择 GPT，目标系统类型选 UEFI
点击「开始」，选择 以 DD 镜像模式写入（重要！）
等待写入完成

务必选择 DD 模式

Rufus 默认使用 ISO 模式，但 Arch Linux 的 ISO 必须使用 DD 镜像模式写入，否则可能无法正常启动。

Linux / macOS 系统#

使用 dd 命令直接写入：

Terminal window

1
#先查看 U 盘设备名
2
$ lsblk
3

4
# 取消挂载 U 盘（假设为 /dev/sdb）
5
$ sudo umount /dev/sdb*
6

7
# 写入镜像（注意 of= 后面是整个设备，不是分区）
8
$ sudo dd if=archlinux-version-x86_64.iso of=/dev/sdb bs=4M status=progress oflag=sync
9

10
# 等待写入完成后同步
11
$ sync

危险操作

dd 命令中 of= 参数必须正确，写错设备会覆盖其他磁盘的数据！请务必通过 lsblk 确认 U 盘设备名。

1.3BIOS / UEFI 设置#

将 U 盘插入电脑，开机时按下对应键进入 BIOS/UEFI 设置（不同品牌按键不同）：

品牌	进入 BIOS 按键	启动菜单按键
联想 / ThinkPad	F1 / F2	F12
戴尔	F2	F12
惠普	F10 / Esc	F9
华硕	F2 / Del	Esc / F8
微星 / 技嘉	Del	F11 / F12

在 BIOS 中需要完成以下设置：

关闭 Secure Boot（安全启动） — Arch 安装镜像不支持 Secure Boot[1]
设置 U 盘为第一启动项 — 在 Boot 菜单中将 U 盘移到最前
确认引导模式为 UEFI — 确保没有启用 CSM/Legacy 模式
关闭 Fast Boot（快速启动） — 避免 USB 设备初始化失败
保存并退出（通常按 F10）

2.进入安装流程#

从 U 盘启动后，会出现引导菜单。选择 Arch Linux install medium 并按回车。稍等片刻后，系统会自动以 root 用户登录，并显示 Zsh 命令行提示符 `root@archiso ~ #

小技巧

如果你觉得终端字体太小（尤其在 HiDPI 屏幕上），可以执行 setfont ter-132b 放大字体。

2.1连接网络#

Arch 安装需要从网络下载软件包，因此必须先联网。

有线网络#

如果使用网线，插入网线后通常会自动获取 IP 地址（DHCP），无需额外操作。

无线网络 (Wi-Fi)#

使用 iwctl 工具连接 Wi-Fi：

Terminal window

1
#进入 iwctl 交互模式
2
iwctl
3

4
# 在 iwctl 提示符内执行：
5
device list                                    # 查看无线网卡名（如 wlan0）
6
station wlan0 scan                            # 扫描网络
7
station wlan0 get-networks                    # 列出可用网络
8
station wlan0 connect "你的WiFi名称"           # 连接（会提示输入密码）
9
quit                                            # 退出

验证网络连接#

Terminal window

1
ping -c 4 archlinux.org
2

3
#如果能收到回复，说明网络正常

2.2更新系统时钟#

Terminal window

1
# 启用 NTP 时间同步
2
timedatectl set-ntp true
3

4
# 查看时间状态（确认 System clock synchronized: yes）
5
timedatectl status

2.3更新镜像源（推荐）#

Terminal window

1
# 使用 reflector 自动选择中国地区最快的 5 个镜像
2
reflector --country China --age 12 --protocol https --sort rate --number 5 --save /etc/pacman.d/mirrorlist
3

4
# 或者手动编辑镜像列表，将中国镜像移到最前面
5
nano /etc/pacman.d/mirrorlist

在文件中找到以下行，确认它们在列表顶部（如果被 # 注释了，请取消注释）：

Terminal window

1
Server = https://mirrors.tuna.tsinghua.edu.cn/archlinux/$repo/os/$arch
2
Server = https://mirrors.ustc.edu.cn/archlinux/$repo/os/$arch
3
Server = https://mirrors.huaweicloud.com/archlinux/$repo/os/$arch

3.磁盘分区#

这是整个安装过程中最需要小心的步骤。本教程采用 UEFI + GPT 分区方案。

Warning

磁盘分区操作中含有擦除磁盘操作，请注意备份数据！

3.1查看磁盘信息#

Terminal window

1
# 使用 lsblk 查看磁盘和分区（推荐）
2
lsblk
3

4
# 或使用 fdisk 查看详细信息
5
fdisk -l

典型的输出如下，你需要找到你要安装 Arch 的目标磁盘：

Terminal window

1
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
2
sda      8:0    0 60G  0 disk               ← 这是你的目标硬盘
3
sr0 11:0    1 1.5G  0 rom  /run/archiso/bootmnt             ← 安装源

注意

请仔细确认你要操作的磁盘设备名。SATA 硬盘通常是 /dev/sda，NVMe 硬盘通常是 /dev/nvme0n1。**后续命令中的 **/dev/sdX请替换为你的实际磁盘名。

3.2分区方案#

本教程采用以下分区方案（UEFI + GPT）：

挂载点	分区	分区类型	建议大小	文件系统
`/boot`	`/dev/sdX1`	EFI System Partition	1 GiB	FAT32
`[SWAP]`	`/dev/sdX2`	Linux swap	≥ 4 GiB	swap
`/`	`/dev/sdX3`	Linux root (x86-64)	剩余空间	ext4

建议

Swap 大小建议为物理内存的 1-2 倍。如果你有 16GB 内存，建议设 8-16GB swap。也可以安装后使用 zram 替代 swap 分区来节省磁盘空间[1]。

使用 cgdisk 进行分区（推荐，图形化 TUI）#

推荐使用 cgdisk，它有可视化界面，操作更直观：

Terminal window

1
cgdisk /dev/sdX

cgdisk 操作步骤#

创建第一个分区（EFI 引导分区）：

用方向键选中空闲空间，按回车选择 [ New ]
First sector：直接回车（使用默认值）
Size in sectors：输入 1G
Hex code or GUID：输入 EF00（EFI System Partition）
Enter new partition name：输入 efi（或直接回车）

创建第二个分区（Swap 交换分区）：

选中剩余空间，选择 [ New ]
First sector：回车默认
Size：输入 8G（根据你的内存调整）
Hex code：输入 8200（Linux swap）
Name：输入 swap

创建第三个分区（根分区）：

选中剩余空间，选择 [ New ]
First sector：回车默认
Size：直接回车（使用全部剩余空间）
Hex code：输入 8304（Linux root x86-64）
Name：输入 root

保存退出：

选择 [ Write ]，输入 yes 确认写入
选择 [ Quit ] 退出

**长图教程警告？？！！**👇

使用 fdisk 进行分区（命令行方式）#

如果你更喜欢纯命令行，可以使用 fdisk：

Terminal window展开收起

1
# fdisk /dev/sdX
2

3
# 创建 GPT 分区表（如果磁盘已有分区，先删除）
4
Command (m for help): g                    # 创建新的 GPT 分区表
5

6
# === 创建 EFI 分区 ===
7
Command (m for help): n                    # 新建分区
8
Partition number (1-128, default 1):     # 回车默认
9
First sector:                             # 回车默认
10
Last sector: +1G                           # 1GB 大小
11
Command (m for help): t                    # 修改分区类型
12
Partition type: 1                           # 选择第一个分区
13
Hex code or alias: uefi                    # 或输入 EF00
14

15
# === 创建 Swap 分区 ===
16
Command (m for help): n
17
Partition number (2-128, default 2):     # 回车默认
18
First sector:                             # 回车默认
19
Last sector: +8G                           # 8GB swap（按需调整）
20
Command (m for help): t
21
Partition number: 2
22
Hex code or alias: swap                    # 或输入 8200
23

24
# === 创建根分区 ===
25
Command (m for help): n
26
Partition number (3-128, default 3):     # 回车默认
27
First sector:                             # 回车默认
28
Last sector:                               # 回车，使用全部剩余空间
29
Command (m for help): t
30
Partition number: 3
31
Hex code or alias: linux-root             # 或输入 8304
32

33
# === 保存写入 ===
34
Command (m for help): p                    # 打印分区表确认
35
Command (m for help): w                    # 写入磁盘并退出

展开收起

3.3验证分区结果#

Terminal window

1
lsblk
2

3
# 应该能看到类似这样的结果：
4
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
5
sda      8:0    0    60G  0 disk
6
├─sda1   8:1    0     1G  0 part              ← EFI
7
├─sda2   8:2    0     8G  0 part              ← swap
8
└─sda3   8:3    0    51G  0 part              ← root

4.格式化与挂载#

4.1格式化分区#

分区创建完成后，需要为每个分区创建文件系统：

Terminal window

1
# 1. 格式化 EFI 分区为 FAT32
2
mkfs.fat -F 32 /dev/sdX1
3

4
# 2. 格式化 swap 分区
5
mkswap /dev/sdX2
6

7
# 3. 格式化根分区为 ext4
8
mkfs.ext4 /dev/sdX3

注意

如果磁盘上已有其他操作系统的 EFI 分区，不要重新格式化它，否则会破坏其他系统的引导。本教程假设是在全新磁盘上操作。

4.2挂载分区#

按照顺序挂载分区 — 先挂载根分区，再挂载 EFI 分区:

Terminal window

1
# 1. 挂载根分区到 /mnt
2
mount /dev/sdX3 /mnt
3

4
# 2. 创建 boot 目录并挂载 EFI 分区
5
mount --mkdir /dev/sdX1 /mnt/boot
6

7
# 3. 启用 swap
8
swapon /dev/sdX2
9

10
# 4. 验证挂载情况
11
lsblk -f

挂载顺序很重要

必须先挂载根分区 /mnt，然后才能在其下创建 /mnt/boot 并挂载 EFI 分区。如果顺序反了，EFI 分区会被根分区的文件系统覆盖。

5.安装基本系统#

使用 pacstrap 脚本将基本系统安装到挂载的 /mnt 目录中。

5.1更新软件源#

Terminal window

1
pacman -Sy

5.2安装必须的软件包#

必要的软件包列表，按需安装：

base	唯一的必需软件包
linux	linux内核（https://wiki.archlinuxcn.org/wiki/%E5%86%85%E6%A0%B8）依照链接介绍选择自己需要的linux内核进行安装
linux-firmware	固件
amd-ucode	用于硬件错误和安全修复（根据自己的处理器选择安装）
intel-ucode	用于硬件错误和安全修复（根据自己的处理器选择安装）
networkmanager	联网工具
neovim	命令行文本编辑器
sudo	sudo
使用如下命令安装：

Terminal window

1
pacstrap -K /mnt base linux linux-firmware

5.3生成 fstab 文件#

fstab 文件定义了系统启动时自动挂载的分区:

Terminal window

1
# 使用 UUID 生成 fstab
2
genfstab -U /mnt >> /mnt/etc/fstab
3

4
# 检查生成结果（应包含三个分区的信息）
5
cat /mnt/etc/fstab

确认输出中包含根分区、EFI 分区和 swap 的条目。如果缺失，说明前面挂载步骤有问题。

5.4进入 chroot 环境#

arch-chroot 将你的根目录切换到新安装的系统中，后续所有命令都在新系统环境中执行:

Terminal window

1
arch-chroot /mnt
2

3
# 此后提示符会变化，表示你已进入新系统
4
[root@archiso /]#

5.5设置时区#

Terminal window

1
# 设置为上海时区（中国标准时间）
2
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
3

4
# 同步硬件时钟到系统时钟
5
hwclock --systohc

5.6本地化设置#

设置系统语言和字符编码:

Terminal window展开收起

1
# 1.安装nano
2
pacman -S nano
3

4
# 2. 编辑 locale.gen 文件
5
nano /etc/locale.gen
6

7
# 在文件中找到以下两行，去掉前面的 # 号取消注释：
8
en_US.UTF-8 UTF-8
9
zh_CN.UTF-8 UTF-8
10

11
# 3. 生成 locale
12
locale-gen
13

14
# 4. 设置系统语言（建议先用英文，避免终端乱码）
15
echo "LANG=en_US.UTF-8" > /etc/locale.conf

展开收起

为什么先用英文？

在纯命令行终端（TTY）中，中文字符无法正常显示，会出现乱码（方块/问号）。等安装好桌面环境和中文字体后，再改为 zh_CN.UTF-8 即可正常显示中文。

5.7设置主机名#

Terminal window

1
# 设置你的电脑名称（自定义，例如 arch）
2
echo "arch" > /etc/hostname
3

4
# 编辑 hosts 文件
5
nano /etc/hosts

在 /etc/hosts 文件中添加以下内容：

Terminal window

1
127.0.0.1   localhost
2
::1         localhost
3
127.0.1.1   arch.localdomain   arch

（将 arch 替换为你设置的主机名）

5.8设置 root 密码#

Terminal window

1
passwd
2

3
#New password:          # 输入密码（不会显示）
4
#Retype new password:    # 再次输入确认

5.9配置网络服务#

启用 NetworkManager，确保安装后系统能自动联网:

Terminal window

1
#安装NetworkManager
2
pacman -S networkmanager
3

4
# 启用 NetworkManager 开机自启
5
systemctl enable NetworkManager

如果不启用 NetworkManager，重启后系统将无法自动联网，你会被困在命令行中无法使用 Wi-Fi。这是新手最容易犯的错误之一。

6.安装引导程序#

引导程序（Bootloader）负责在开机时加载 Linux 内核。本教程使用 GRUB，这是最通用、文档最丰富的引导程序

6.1安装 GRUB 和相关工具#

Terminal window

1
# 安装 GRUB 和 EFI 引导管理器
2
pacman -S grub efibootmgr

6.2安装 GRUB 到 EFI 分区#

Terminal window

1
#安装efibootmgr
2
pacman -S efibootmgr
3

4
# 将 GRUB 安装到 EFI 分区
5
grub-install --target=x86_64-efi \
6
    --efi-directory=/boot \
7
    --bootloader-id=GRUB
8

9
# 成功时会显示：Installation finished. No error reported.

常见错误

如果报错 efibootmgr: not found，说明 efibootmgr 没装好，执行 pacman -S efibootmgr 安装。如果报 EFI variables are not supported，说明你实际上在 BIOS 模式下，需要重启检查 BIOS 设置。

6.3生成 GRUB 配置文件#

Terminal window

1
# 自动生成 grub.cfg 配置文件
2
grub-mkconfig -o /boot/grub/grub.cfg

确认微码加载

输出中如果出现 Found microcode image 行，说明 CPU 微码已正确集成到引导配置中。如果没有，检查 intel-ucode 或 amd-ucode 是否已安装。

关于 os-prober 警告

如果你需要双系统（如 Windows），记得编辑 /etc/default/grub，加入：

Terminal window

1
GRUB_DISABLE_OS_PROBER=false

然后安装 os-prober 包，再重新运行 grub-mkconfig。

7.创建普通用户#

日常使用不应直接使用 root 账户，需要创建一个普通用户并赋予 sudo 权限。

7.1创建用户#

Terminal window

1
# 创建用户（将 yourname 替换为你的用户名）
2
useradd -m -G wheel -s /bin/bash yourname
3

4
# 设置用户密码
5
passwd yourname

参数说明

-m — 创建用户主目录 /home/yourname
-G wheel — 将用户加入 wheel 组（sudo 权限组）
-s /bin/bash — 设置默认 shell 为 bash

7.2配置 sudo 权限#

Terminal window

1
# 编辑 sudoers 文件（必须用 visudo！）
2
EDITOR=nano visudo
3

4
# 找到这一行，去掉前面的 # 号取消注释：
5
# %wheel ALL=(ALL:ALL) ALL
6
# 改为：
7
%wheel ALL=(ALL:ALL) ALL

务必使用 visudo

不要直接用 nano /etc/sudoers 编辑。visudo 会在保存时检查语法，防止配置错误导致 sudo 完全不可用。如果你设了 EDITOR=nano，它会用 nano 打开。

7.3退出 chroot#

如果你只想要命令行系统，现在可以跳到后文8.12部分的「退出 chroot 并重启」部分。但如果你要安装桌面环境，请继续在 chroot 环境中操作。

8.安装桌面环境#

Arch Linux 默认只有命令行界面。要获得图形桌面，需要安装桌面环境（DE）和显示管理器（登录界面）。以下是几个主流选择：

桌面环境	特点	RAM 占用
GNOME	现代简洁，开箱即用，Ubuntu/Fedora 默认桌面	~2 GB
KDE Plasma	功能丰富，高度可定制，Windows 风格	~1.5 GB
XFCE	轻量稳定，低资源占用，老电脑首选	~0.8 GB
Cinnamon	传统桌面布局，Linux Mint 风格	~1.2 GB

如何选择？

新手推荐：KDE Plasma（界面类似 Windows，上手快）或 GNOME（简洁现代）
低配电脑：XFCE（资源占用最低）
喜欢传统桌面：Cinnamon（经典任务栏布局）

你可以安装多个桌面环境，在登录界面切换。但建议初学者只装一个，避免配置冲突。

本文因在虚拟机内安装，所以选择XFCE。实际请根据自己的需求进行选择

8.1安装 GNOME 桌面#

GNOME 是最流行的现代 Linux 桌面环境之一，界面简洁，操作直观

Terminal window

1
# 安装 GNOME 桌面环境 + 显示管理器 + 调整工具
2
pacman -S gnome gnome-tweaks
3

4
# 启用 GDM（GNOME 显示管理器）开机自启
5
systemctl enable gdm

GNOME 包说明

gnome — 包含 GNOME 桌面核心组件、GDM 显示管理器和常用应用
gnome-tweaks — GNOME 调整工具，用于自定义主题、字体、扩展等

8.2安装 KDE Plasma 桌面#

KDE Plasma 功能强大且高度可定制，界面风格类似 Windows，新手容易上手

Terminal window

1
# 安装 KDE Plasma 桌面 + SDDM 显示管理器 + 常用应用
2
pacman -S plasma sddm \
3
    dolphin konsole kate \
4
    plasma-desktop plasma-nm
5

6
# 启用 SDDM 显示管理器
7
systemctl enable sddm

KDE 包说明

plasma — KDE Plasma 桌面元包
sddm — 显示管理器（登录界面）
dolphin — 文件管理器
konsole — 终端模拟器
kate — 文本编辑器
plasma-nm — 网络管理小部件（Wi-Fi 管理）

8.3安装 XFCE 桌面#

XFCE 是轻量级桌面环境，资源占用低，适合老旧硬件或追求性能的用户

Terminal window

1
# 安装 XFCE + LightDM 显示管理器
2
pacman -S xfce4 xfce4-goodies lightdm \
3
    lightdm-gtk-greeter
4

5
# 启用 LightDM
6
systemctl enable lightdm

8.4安装 Cinnamon 桌面#

Cinnamon 提供传统桌面布局，类似 Windows 的开始菜单和任务栏

Terminal window

1
# 安装 Cinnamon + LightDM
2
pacman -S cinnamon lightdm \
3
    lightdm-gtk-greeter
4

5
# 启用 LightDM
6
systemctl enable lightdm

8.5安装中文字体#

安装桌面环境后，必须安装中文字体，否则中文会显示为方块/乱码：

Terminal window

1
# 安装常用中文字体
2
pacman -S noto-fonts-cjk \
3
    noto-fonts-emoji \
4
    wqy-microhei \
5
    wqy-zenhei \
6
    ttf-dejavu
7

8
# 安装完成后，将系统语言改为中文（可选）
9
echo "LANG=zh_CN.UTF-8" > /etc/locale.conf

8.6安装音频支持#

现代 Linux 桌面使用 PipeWire 作为音频服务器：

Terminal window

1
# 安装 PipeWire 音频系统
2
pacman -S pipewire pipewire-pulse \
3
    pipewire-alsa pipewire-jack \
4
    wireplumber
5

6
# KDE 用户可额外安装音量控制小部件
7
pacman -S plasma-pa
8

9
# GNOME 用户无需额外安装，已内置🤔

8.7安装显卡驱动#

根据你的显卡品牌安装对应驱动：

显卡品牌	驱动包	安装命令
Intel 集成显卡	mesa	`pacman -S mesa vulkan-intel`
AMD 显卡	mesa	`pacman -S mesa vulkan-radeon lib32-mesa lib32-vulkan-radeon`
NVIDIA（新卡）	nvidia	`pacman -S nvidia nvidia-utils`
NVIDIA（老卡）	nvidia-470xx-dkms	从 AUR 安装
虚拟机	无需额外驱动(如果你是PVE等设备显卡直通了可以按照上方的安装对应驱动)	————

NVIDIA 驱动注意事项

如果你使用 NVIDIA 显卡，安装驱动后还需要生成 initramfs。执行 mkinitcpio -P 重新生成。如果是双显卡笔记本，情况更复杂，请查阅 Arch Wiki NVIDIA 页面。

8.8启用 multilib 仓库（32位支持）#

如果你需要运行 Steam 游戏或 Wine 等需要 32 位库的程序：

Terminal window

1
# 编辑 pacman.conf
2
nano /etc/pacman.conf
3

4
# 找到以下两行，去掉前面的 # 号：
5
#[multilib]
6
#Include = /etc/pacman.d/mirrorlist
7
# 改为：
8
[multilib]
9
Include = /etc/pacman.d/mirrorlist
10

11
# 更新包数据库
12
pacman -Sy

8.9安装 AUR 助手（推荐）#

AUR（Arch User Repository）包含大量官方仓库没有的软件。推荐安装 yay 作为 AUR 助手：

Terminal window

1
# 先安装编译依赖
2
pacman -S --needed base-devel git
3

4
# 切换到普通用户
5
su - yourname
6

7
#切换到有读写权限的目录
8
cd /home/yourname
9

10
# 下载并编译 yay
11
git clone https://aur.archlinux.org/yay.git
12
cd yay
13
makepkg -si

yay 使用方法

yay 的用法和 pacman 几乎一样，但它能自动从 AUR 下载、编译和安装软件。例如：yay -S google-chrome。

8.10安装常用软件#

Terminal window展开收起

1
# 浏览器
2
pacman -S firefox firefox-i18n-zh-cn
3

4
# 办公套件
5
pacman -S libreoffice-fresh libreoffice-fresh-zh-cn
6

7
# 输入法（Fcitx5 中文输入法）
8
pacman -S fcitx5 fcitx5-chinese-addons \
9
    fcitx5-configtool fcitx5-gtk fcitx5-qt
10

11
# 媒体播放
12
pacman -S vlc
13

14
# 下载工具
15
pacman -S wget curl

展开收起

8.11配置中文输入法#

安装 Fcitx5 后，需要配置环境变量。编辑 ~/.bashrc（bash）或 ~/.zshrc（zsh）：

Terminal window

1
# 编辑用户配置文件
2
nano ~/.bashrc
3

4
# 在文件末尾添加：
5
export GTK_IM_MODULE=fcitx
6
export QT_IM_MODULE=fcitx
7
export XMODIFIERS=@im=fcitx
8
export SDL_IM_MODULE=fcitx
9
export GLFW_IM_MODULE=ibus

在桌面环境的设置中，将 Fcitx5 添加到开机启动项。登录桌面后，按 Ctrl + Space 切换中英文输入。

8.12退出并重启#

所有配置完成后，退出 chroot 并重启系统：

Terminal window

1
# 退出 chroot
2
exit
3

4
# 卸载挂载的分区（可选但推荐）
5
umount -R /mnt
6

7
# 重启（记得拔掉 U 盘！）
8
reboot

重启前检查清单

已安装引导程序（GRUB）并生成配置
已创建普通用户并配置 sudo
已启用 NetworkManager（systemctl enable NetworkManager）
已启用显示管理器（gdm / sddm / lightdm）
已安装中文字体
已设置 root 密码和用户密码

重启后，你应该能看到显示管理器的登录界面。输入你的用户名和密码，就可以进入桌面环境了！🎉

常见问题#

Q1: 重启后进入 GRUB 命令行，没有菜单#

这通常是因为 GRUB 配置文件没有正确生成。你需要从 U 盘重新启动，挂载分区并 chroot 进去，重新执行：

修复 GRUB

Terminal window

1
# 从 U 盘启动后
2
mount /dev/sdX3 /mnt
3
mount --mkdir /dev/sdX1 /mnt/boot
4
arch-chroot /mnt
5
grub-mkconfig -o /boot/grub/grub.cfg

Q2: 重启后没有网络 / Wi-Fi 不可用#

说明 NetworkManager 没有启用。从 U 盘启动后 chroot 进去：

修复网络

Terminal window

1
arch-chroot /mnt
2
systemctl enable NetworkManager

Q3: 桌面环境启动后中文显示为方块#

缺少中文字体。在 TTY 或终端中执行：

安装中文字体

Terminal window

1
pacman -S noto-fonts-cjk wqy-microhei

Q4: 桌面登录后黑屏 / 无法进入桌面#

可能是显卡驱动问题。尝试以下步骤：

检查是否安装了正确的显卡驱动（参见 11.2 节）
NVIDIA 用户：确保安装了 nvidia 包并执行了 mkinitcpio -P
尝试在 GRUB 启动菜单按 e，在内核参数中添加 nomodeset 临时禁用图形驱动

Q5: 安装过程中 pacman 报密钥错误#

修复密钥

Terminal window

1
# 初始化 pacman 密钥环
2
pacman-key --init
3
pacman-key --populate archlinux
4

5
# 更新密钥环
6
pacman -Sy archlinux-keyring

Q6: 如何在虚拟机中安装？#

虚拟机安装步骤基本相同，但需要注意：

在虚拟机设置中选择 UEFI 引导模式（如果支持）
磁盘设备名可能是 /dev/vda（QEMU/KVM）或 /dev/sda（VirtualBox）

Q7: 如何启用中文 locale？#

安装好桌面和中文字体后，修改系统语言：

切换为中文

Terminal window

1
# 确认 locale.gen 中已取消注释 zh_CN.UTF-8
2
nano /etc/locale.gen
3

4
zh_CN.UTF-8 UTF-8
5

6
# 重新生成 locale
7
locale-gen
8

9
# 设置中文
10
echo "LANG=zh_CN.UTF-8" > /etc/locale.conf
11

12
# 重新登录或重启生效

Q8: 日常维护建议#

定期更新：执行 sudo pacman -Syu 保持系统最新
更新前看新闻：访问 archlinux.org 首页查看是否有需要手动干预的更新
不要部分更新：不要只更新部分包，始终使用 -Syu 全量更新
清理缓存：定期执行 sudo pacman -Sc 清理旧包缓存
备份重要配置：备份 /etc 目录下的自定义配置文件

小结#

🎉 恭喜！如果你顺利走到这一步，说明你已经成功安装了 Arch Linux 并配置好了桌面环境。Arch Linux 是一个滚动更新的发行版，你只需要定期执行 sudo pacman -Syu 就能保持系统永远是最新的。欢迎加入 Arch 社区！

参考文献：

Openlist美化指南

Mon, 27 Jul 2026 00:00:00 GMT

效果展示#

自定义头部#

1
<!-- 引入 polyfill -->
2
<script src="https://polyfill.alicdn.com/v3/polyfill.min.js?features=String.prototype.replaceAll"></script>
3

4
<!-- 引入字体 -->
5
<link rel="stylesheet" href="https://npm.elemecdn.com/lxgw-wenkai-webfont@1.1.0/lxgwwenkai-regular.css" />
6

7
<style>
8
    /* 隐藏底部 */
9
    .footer {
10
        display: none !important;
11
    }
12

13
    /* 背景设置 */
14
    .hope-ui-dark, .hope-ui-light {
15
        background-image: url('https://img.catcdn.cn/ba/') !important;
16
        background-size: cover;
17
        background-attachment: fixed;
18
        background-position: center;
19
    }
20

21
    /*主列表白天模式透明*/
22
    .obj-box.hope-stack.hope-c-dhzjXW.hope-c-PJLV.hope-c-PJLV-igScBhH-css {
23
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
24
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
25
        background-color: rgba(255, 255, 255, 0.3) !important;
26
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
27
    }
28
    /*主列表夜间模式透明*/
29
    .obj-box.hope-stack.hope-c-dhzjXW.hope-c-PJLV.hope-c-PJLV-iigjoxS-css {
30
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
31
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
32
        background-color: rgba(0, 0, 0, 0.3) !important;
33
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
34
    }
35
    /*readme白天模式透明*/
36
    .hope-c-PJLV.hope-c-PJLV-ikSuVsl-css {
37
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
38
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
39
        background-color: rgba(255, 255, 255, 0.3) !important;
40
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
41
    }
42
    /*readme夜间模式透明*/
43
    .hope-c-PJLV.hope-c-PJLV-iiuDLME-css {
44
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
45
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
46
        background-color: rgba(0, 0, 0, 0.3) !important;
47
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
48
    }
49

50
    /*顶部*/
51
    #root > .header {
52
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
53
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
54
        background: rgba(255, 255, 255, 0); /* 透明背景色 */
55
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
56
    }
57

58
    /*导航条*/
59
    /*白天模式*/
60
    .hope-ui-light .body > .nav {
61
        background-color: rgba(255, 255, 255, 0.3);
62
        border-radius: var(--hope-radii-xl);
63
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
64
    }
65
    /*夜间模式*/
66
    .hope-ui-dark .body > .nav {
67
        background-color: rgba(0, 0, 0, 0.3);
68
        border-radius: var(--hope-radii-xl);
69
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
70
    }
71

72
    /*隐藏导航条遮罩*/
73
    .body > .nav::after {
74
        display: none;
75
    }
76

77
    /*右上视图切换菜单*/
78
    /*白天模式*/
79
    .hope-ui-light .hope-c-PJLV-iSMXDf-css {
80
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
81
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
82
        background: rgba(255, 255, 255, 0.3); /* 透明背景色 */
83
        border-radius: 10px;
84
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
85
    }
86
    /*夜间模式*/
87
    .hope-ui-dark .hope-c-PJLV-iSMXDf-css {
88
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
89
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
90
        background: rgba(0, 0, 0, 0.3); /* 透明背景色 */
91
        border-radius: var(--hope-radii-xl);
92
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); /* 阴影效果 */
93
    }
94

95
    /*右下角侧边栏按钮透明 第一个是白天 第二个是夜间*/
96
    .hope-ui-light .hope-c-PJLV-ijgzmFG-css {
97
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
98
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
99
        background-color: rgba(255, 255, 255, 0.3) !important;
100
    }
101
    .hope-ui-dark .hope-c-PJLV-ijgzmFG-css {
102
        backdrop-filter: blur(10px); /* 毛玻璃效果的强度 */
103
        -webkit-backdrop-filter: blur(10px); /* 为 Safari 浏览器添加兼容性 */
104
        background-color: rgba(0, 0, 0, 0.5) !important;
105
    }
106
    /*白天模式代码块透明*/
107
    .hope-ui-light pre {
108
        background-color: rgba(255, 255, 255, 0.1) !important;
109
    }
110
    /*夜间模式代码块透明*/
111
    .hope-ui-dark pre {
112
        background-color: rgba(255, 255, 255, 0) !important;
113
    }
114

115
    /*底部CSS，.App .table这三个一起的*/
116
    dibu {
117
        border-top: 0px;
118
        position: absolute;
119
        bottom: 0;
120
        width: 100%;
121
        margin: 0px;
122
        padding: 0px;
123
    }
124
    .App {
125
        min-height: 85vh;
126
    }
127
    .table {
128
        margin: auto;
129
    }
130

131

132
    /*全局字体*/
133
    * {
134
        font-family: LXGW WenKai;
135
    }
136
    * {
137
        font-weight: bold;
138
    }
139
    body {
140
        font-family: LXGW WenKai;
141
    }
142
</style>

展开收起

自定义内容#

1
<!-- 延迟加载 -->
2
<div id="customize" style="display: none;">
3
    <div>
4
        <br />
5
        <center class="dibu">
6
            <div style=" line-height: 20px;font-size: 9pt;font-weight: bold;">
7
                <span>
8
                    "
9
                    <span style="color: rgb(15, 175, 255); font-weight: bold;" id="hitokoto">
10
                        <a href="#" id="hitokoto_text">
11
                            "与你的日常，便是奇迹！"
12
                        </a>
13
                    </span> "
14
                </span>
15
            </div>
16

17
            <!-- 底部链接 -->
18
            <div style="font-size: 13px; font-weight: bold;">
19
                <span class="nav-item">
20
                    <a class="nav-link" href="https://jerrytom0401@163.com" target="_blank">
21
                        <i class="fa-duotone fa-envelope-open" style="color:#409EFF" aria-hidden="true">
22
                        </i>
23
                        邮箱 |
24
                    </a>
25
                </span>
26
                <span class="nav-item">
27
                    <a class="nav-link" href="https://www.jerry-nis.top/" target="_blank">
28
                        <i class="fas fa-edit" style="color:#409EFF" aria-hidden="true">
29
                        </i>
30
                        博客 |
31
                    </a>
32
                </span>
33
                <!--后台入口-->
34
                <span class="nav-item">
35
                    <a class="nav-link" href="/@manage" target="_blank">
36
                        <i class="fa-solid fa-folder-gear" style="color:#409EFF;" aria-hidden="true">
37
                        </i>
38
                        管理 |
39
                    </a>
40
                </span>
41
                <!--版权，请尊重作者-->
42
                <span class="nav-item">
43
                    <a class="nav-link" href="https://github.com/Xhofe/alist" target="_blank">
44
                        <i class="fa-solid fa-copyright" style="color:#409EFF;" aria-hidden="true">
45
                        </i>
46
                        Openlist
47
                    </a>
48
                </span>
49
            </div>
50
        </center>
51
        <br />
52
    </div>
53

54
    <!--一言API-->
55
    <script src="https://v1.hitokoto.cn/?encode=js&select=%23hitokoto" defer></script>
56
<!--延迟加载范围到这里结束-->
57
</div>
58

59
<!-- 延迟加载JS -->
60
<script>
61
    let interval = setInterval(() => {
62
        if (document.querySelector(".footer")) {
63
            document.querySelector("#customize").style.display = "";
64
            clearInterval(interval);
65
        }
66
    }, 200);
67
</script>

展开收起

OpenFG插帧补帧软件使用指南

Fri, 24 Jul 2026 00:00:00 GMT

前言#

有时候我们在爽完游戏的时候，明明手机有120、144高刷，但是游戏却不支持，该怎么办呢😭

有时候我们在爽完游戏的时候，手机性能跟不上，开60刷新率就掉帧，该怎么办呢😭

厂商云控温控发力，游戏锁帧，功率过高，该怎么解决呢😭

插帧工具能给你一个比较完美的选择(性能过低的设备不建议启用插帧功能，会加剧卡顿)。

目前主流的插帧软件有NeoM irror、AVU、VSCO、NV、Blurrr-AMV、timefreeze、timeCut、AE动效忍者等，本文介绍的是最近新出的一款插帧软件。它依赖于模块和Root，理论兼容性等效果更佳。

截止到本文发布OpenFG版本为1.0.0。

警告

本教程仅适用于已解BL锁已Root的设备在操作前请确保你的数据已备份或拥有救机的能力，否则后果自负！

操作步骤#

基础#

前往Github仓库下载模块以及应用，安装本体并给予本体Root权限。
在你的Root管理器安装模块并重启(需有前置Zygisk，magisk可在设置中开启，kernelsu等管理器可安装zygisk next模块)
打开软件，通过引导页。(若发现进入首页只有一个OpenFG或者没有应用请手动到系统设置里给予OpenFG应用获取权限)
打开应用，点击左上角扳手图标，检查配置是否全部可用，若有异常可自行AI解决
勾选你需要插帧/补帧的游戏或应用，并点击打开配置

如何配置#

Enable OpenFG：（顾名思义开启openfg，关了就不插帧）
Show floating menu：是否在左上角显示帧率信息[实际帧率/插帧后帧率]
Frame generation：

Multiplier：倍率插帧，插帧后帧率为实际帧率的倍数。
Target FPS：固定目标帧率

提示

二者只有一个生效。

Activation floor：在帧率低于设定的帧率后进行插帧
Flow:

Engine ：游戏选择Hardware，性能最优；视频选择Video。
Flow scale：插针分辨率，越低画面越模糊。
Upscaler：缩放算法；FSR1画面表现效果最佳，高通机型推荐SGSR。
Sharpness：锐度调整。

HDR：

Brightness（亮度滑块）
Highlight boost（高光增强滑块）
Shadow depth（阴影深度滑块）
Contrast（对比度滑块）
Saturation（饱和度滑块）

Graphics API：图形接口，OpenGL兼容性最佳，Vulkan性能最佳。
Alternative VK Capture<解决悬浮窗黑屏>、只捕获 UI 菜单、无画面的问题；开启后会强制 API 切换为 Vulkan。
Video playback FG<在给视频播放软件插帧时需开启>，游戏需关闭。

感谢你的阅读，希望你能收获新的知识。参考文献：

OpenFGG/openfg-app：用于安卓游戏的插值帧生成

NotionNext免费搭建博客指南

Mon, 20 Jul 2026 00:00:00 GMT

前言#

Notion是什么#

Notion是一款一体化模块化数字工作台，以积木式区块为核心，整合笔记、文档、数据库、看板等功能，搭配双向链接、原生AI与海量模板，无需代码就能搭建知识库、任务系统与个人主页，支持多端同步和团队协作，是适合博主记录素材、整理文稿、搭建内容库的全能工具。作为博客编辑器非常方便便利。

NotionNext是什么#

NotionNext基于Next.js开发的将Notion笔记转为静态博客网页的开源项目，它可以帮助你免费的搭建自己的网站，让别人了解你的想法。

博客优势与缺点#

	NotionNext	Hexo	Hugo	Wordpress	Astro	Halo
优势	专门面向独立博客 / 资讯站，开箱即用完整博客系统，无需从零搭框架。内置管理面板，不用本地写 md，网页端直接发文。对国内服务器、CDN、图床兼容性更好。基础功能全部集成，不用额外装插件。一站式编辑，小白上手难度低。	轻量极速，纯静态页面访问速度快。中文主题生态完善，大量国人制作精美主题。上手难度适中，Markdown写作简单，支持免费静态部署，无服务器开销。	Go语言构建速度极强，千篇文章毫秒生成；原生图片压缩、多语言、搜索、分页；资源占用极低；支持多种文档格式。	生态极其丰富，海量主题插件；可视化后台零代码操作；建站全场景适配，托管一键安装。	混合SSG/SSR渲染，默认零JS页面极速；可混用Svelte/Vue/React组件；内置图片优化、RSS、Sitemap；全平台免费静态部署。	国产可视化后台，网页端直接发文；中文主题插件生态完善；Docker一键部署；性能优于WordPress，社区持续更新维护。
缺点	主题、插件数量远不如 WP、Hexo、Astro，自定义空间小，修改主题繁琐。基于自研架构，深度二次开发门槛高。免费部署支持性差。	文章百篇以上构建速度变慢；无原生后台，评论、统计等功能需对接第三方；本地dev预览刷新慢；插件体系老旧，核心更新缓慢。	Go模板语法晦涩，上手门槛高；中文主题稀缺；插件生态薄弱；热重载调试体验一般；动态功能全部依赖第三方。	PHP+数据库动态架构，高并发卡顿；代码冗余臃肿；插件漏洞多、安全风险高；长期使用需要付费服务器维持。	成熟主题偏少；大版本更新易出现依赖兼容报错；无可视化后台，纯小白发文门槛高；SSR部署需要额外适配。	依赖Java运行环境，低配服务器内存占用高；无法零成本静态托管；主题自研模板引擎，前端自定义改造限制大。

操作步骤#

创建Notion页面#

前往Notion注册并登录账号。
打开Notion 博客模板并点击右上角的复制按钮将模板复制到自己的Notion点击添加到私人空间

获取页面ID#

点击进入模板点击页面右上角的共享-发布-发布，获得网页地址

点击查看网站，进入到创建的页面中。复制地址栏的地址，其中/后，?前的字符串的为页面ID 例:[https://autumn-aurora-837.notion.site/52e7398bf7298236937a012188707812?v=f7f7398bf729831cb466087545e80d5c 中，52e7398bf7298236937a012188707812为我的页面ID

部署#

仓库配置#

注册Github(此处不再赘述)
点击Fork项目一键Fork项目到自己的仓库

Vercel部署#

注册Vercel账号并连接到Github(此处不再赘述)
点击New Project新建项目，并导入刚刚Fork的仓库
配置环境变量：点击Environment Variables，添加一个属性名称为NOTION_PAGE_ID，值为刚刚获取的页面ID。
点击Deploy进行部署，等待几分钟即可部署完成😋

添加域名#

部署完成后点击下面的Add Domain
点击Add Existing
前往自己的域名DNS编辑，添加你填写的域名的CNAME解析
回到vercel，刷新并等待一会后就添加完成了

小结#

在部署完成后，你可以前往Notion个人工作空间-Notion博客页配置你的网站、写发文章了。可以根据NotionNext 使用说明进行个性化设置以及文章编写

参考文献：

安卓类原生刷入指南

Sun, 19 Jul 2026 00:00:00 GMT

前言#

提示 > 本教程仅适用于已解锁Bootloader的安卓设备！

警告 > 搞机有风险，刷机需谨慎！请注意备份自己的数据，出现问题概不负责！刷入后设备原有数据将会被彻底清除，注意备份数据！！

你是否已经厌倦自己手机厂商的定制系统？想要体验新的UI以及不同的功能？

AOSP类原生项目为你提供了一个很好的选择！

目前主流的类原生项目有LineageOS、Crdroid、Evolution X、RisingOS、Pixel Experience等，你可以前往对应的下载站下载卡刷压缩包进行刷机操作。

本文以红米K60为例，刷入LunarisAOSP，并记录其过程。

操作步骤#

获取工具#

前往Android Developers下载自己设备适用的ADB工具，并解压的空闲目录备用（此处使用windows版） windows设备部分版本windows需装adb驱动，前往一键安装安卓驱动-官网下载并安装驱动即可

获取卡刷包#

前往类原生项目的下载站获取卡刷包

例如此处mondrian机型Lunaris 3.12卡刷包地址为Artifact Explorer

若有Partition Images下载，下载下来recovery.img、
vbmeta.img这四个文件备用。

若无这些镜像，可以从卡刷包中提取(根目录若没有的话，则可以从payload.bin中提取)

刷入恢复分区(Recovery)#

将手机关机，按下开机键+音量减键进入FastBoot模式，并将数据线插入手机

在你解压ADB工具的根目录下(有.exe文件的目录)，在地址栏输入cmd打开命令提示符

输入fastboot devices

若一切正常，应输出你的设备id：

依次输入以下的指令

Terminal window

1
##刷入镜像
2
fastboot flash recovery 你的recovery.img文件
3
fastboot flash vbmeta 你的vbmeta.img文件
4
##重启设备到恢复模式(Recovery)[或使用电源键+音量加键]
5
fastboot reboot recovery

Recovery示例图：

刷入卡刷包#

通过音量键+-控制上下，电源键确定进入Apply update，接着选择Apply from ADB

接着在cmd输入adb devices

若一切正常，应输出你的设备id：

接着在cmd输入adb sideload 你的卡刷包文件地址，并等待刷写完毕

若中途出现如下界面提示重启，选择YES

刷写完毕后，进入Factory reset，Format data/factory reset，并选择Format data以清除Data数据保证正常开机

清除后，返回主菜单，并选择第一项Reboot system now进行重启

配置系统#

开机后正常配置完手机即可

接下来，你就可以体验流畅丝滑的类原生了😋

[AI]在手机上本地运行图片生成AI

Thu, 16 Jul 2026 00:00:00 GMT

前言#

Localdream是一个安卓本地的Stable Diffusion工具，它允许使用CPU/GPU或骁龙NPU进行图片渲染

它拥有多种风格的模型可以使用，当然你也可以从模型网站上自己下载模型导入使用。

设备要求：CPU渲染至少需要6G内存，NPU渲染至少8G内存，建议至少有2G空余内存的设备进行使用

注意

NPU加速推理仅支持搭载部分骁龙芯片的安卓手机使用，天玑等仅能使用CPU推理

生成示例：

操作步骤#

获取Localdream#

前往LocalDream官方Github仓库，进入Releases获取安装包

提醒

第一项为正常版本 with_filter为屏蔽不良内容版本

下载完成后进行安装

使用#

***此处使用NPU模型作示例，CPU模型操作步骤相同

选择你想生成的图片风格模型并点击下载(若下载速度过慢可以使用魔法或者前往设置使用国内下载源)

下载完成后即可点击选项卡进入生成页

其中img2img(img to img)为图片生成图片，即根据你提供的图片进行二次图片生成

提示词设置：

图像生成提示：即你想生成的图像提示词，不支持中文，英文效果最好。
负面提示：即不想让它生成的内容，可以使用负面提示词来让生成结果更贴近你想要的结果

高级参数设置

分辨率：即生成出来的图片分辨率，分辨率越大消耗的时间、资源越多
调度器：不同画面风格的采样器，影响画面色彩等[Karras<降噪算法>，能够提升画面细节]
生成步数：降噪绘制的次数，次数越多图像越细节，但是会增加渲染时间。（推荐使用20~28步，细节完整耗时适中。30步以上细节提升较小但消耗的时间多）
CFG Scale<可以理解为文字语言大模型的>”温度”，即提示词对画面的约束力。数值越高画面越贴近所给的提示词。（推荐6~8，关键词渲染精准，色彩自然。超过10画面会比较奇怪，不推荐）
批次数量：即想要一次性生成的图片数
[img2img]Denoise Strength<即对原图的修改力度>(推荐0.6)
随机种子：输入喜欢的AI图片的种子，在本次生成中可以使用种子图片的构图模板等（留空则纯随机）
CPU渲染会有一个Runtime选项，可以选择CPU或GPU渲染

点击生成后等待一会即可输出生成结果

第一个按钮即收藏，第二个按钮为超分辨率，第三个按钮即保存到相册点击超分辨率按钮后，下载画风模型即可使用。超分辨率对比图：未超分

已超分

已知问题#

Q：我下载解压完模型后，点击打开等了半天为什么出现无法连接到后端错误？

A：关闭魔法、代理等，使用普通WIFI、流量进行使用，开启代理会导致前端无法连接至SD绘图后端

参考链接：Localdream Github

Local Dream Docs

搭建自己的在线网站监测网页

Wed, 15 Jul 2026 00:00:00 GMT

前言#

当你有了多个网站后，是否很难及时查看它们的在线状况？

没关系，现在有一个项目能够帮助你查看自己网站的在线情况以及情况统计😋

本文使用vercel部署，请确保你有可以正常使用的vercel账号

预览地址

操作步骤#

申请API及配置站点#

前往UptimeRobot并注册登录

点击右上角的New按钮新建一个监测

![[Pasted image 20260715220209.png]]

回到首页你就能看见你的第一个监测创建成功了 ![[Pasted image 20260715220250.png]]

来到API页面，点击创建主API并复制它备用。 ![[Pasted image 20260715220350.png]]

部署监测网页#

前往这个项目imsyy/site-status

划到下方，点击vercel的部署按钮

网站会自动跳转到vercel进行部署

很明显这有问题，因为我们的步骤还没有完成点击前往仪表盘并前往环境变量配置如图所示添加两个变量即可

1
DEPLOYMENT_PLATFORM  auto
2
API_KEY   你刚刚保存备用的API Key

点击重新部署

等待构建完成后访问vercel提供的地址即可访问

如果有自己的域名的话可以前往domains选项卡添加自己的域名

参考文献：

imsyy/site-status

在安卓设备上利用Droidspace运行原生性能linux

Tue, 14 Jul 2026 00:00:00 GMT

前言#

droidspace是一项较新的项目，它是一款轻量级、可移植的 Linux 容器化工具。

它可以以原生的性能运行在你的安卓，linux设备上。

更多特性可以前往Droidspace的GitHub仓库查看具体实现技术。

本文使用了红米K60手机，系统为A16的澎湃3.0.8，内核为修补后支持droidspace的5.10内核，root管理器为kernels。

警告

本教程仅适用于已解BL锁已Root的设备在操作前请确保你的数据已备份或拥有救机的能力，否则后果自负！

操作步骤#

刷入内核#

前往Goldbug网盘，下载自己设备的内核包

K60使用GKI内核/AnyKernel3_gki_5.10.252_NTsync_Kswapd解耦_github @Star-ZER0.zip

前往HorizonKernelFlasherGithub仓库下载并安装刷写工具

前往Root管理器给与ROOT权限

接着按照下图所示选择你下载的内核包，待刷写完成后重启

安装droidspace并配置容器#

前往DroidspaceGithub仓库，进入releases下载APK并安装

安装完后前往kernelsu给与ROOT权限

打开软件，进行OOBE配置后打开设置-要求，检测当前设备是否满足运行要求

前往GoldBug下载站，下载自己需要的Rootfs(网站下面有各个版本的说明，按需选择)

下载完成后，回到软件，安装容器

容器详细设置根据自己需求自行配置即可

点击运行即可开启容器

可以自行配置ssh，容器可以当作一台小型linux服务器。

容器占用内存400MB，日常后台影响较小，性能优越。

感谢作者酷安@Goldbus

利用Astro搭建自己的博客

Mon, 13 Jul 2026 00:00:00 GMT

前言#

此篇教程是本人根据文档等自行探索出的小白教程，如有错误请指出

教程使用的是Firefly模板/主题的astro

前提条件：

有一台linux、windows、macos设备(此处以windows设备为教程设备)
能够顺畅的访问Github
有自己的一级域名(可选)

安装基础环境#

前往Nodejs官网(Node.js — 在任何地方运行 JavaScript)下载自己设备的安装包并点击安装

(无脑点击下一步直到安装完成)

打开Windows Terminal/CMD

输入如下指令

Terminal window

1
npm -v

如有以下输出则安装成功

输入

Terminal window

1
npm install -g pnpm

等待运行完毕后输入

Terminal window

1
pnpm -v

若有以下输出则代表pnpm安装成功

下载Git工具Git - Install for Windows以克隆模板项目

(根据自己的设备选择合适的安装包)

打开安装包后点击下一步，勾选下图选项即可

接着后余选项一直下一步即可直至安装完毕

克隆项目#

克隆仓库#

Terminal window

1
git clone https://github.com/CuteLeaf/Firefly.git
2
cd Firefly

提示> 如果git不下来可以手动下载解压使用。

安装依赖#

Terminal window

1
pnpm install

正常输出如下

测试项目#

输入

Terminal window

1
pnpm dev

提示> 实际上端口为4321，我在写文章时开了两个实例，端口自动叠加导致的4322端口，轻请以实际输出为准！

在你的浏览器中输入网址http://localhost:XXXX/

若成功访问，则说明你的操作正确，可以进行下一步。

自定义项目#

根据主题官方文档Firefly Docs个性化你的博客，文档内容详细丰富

此处不再赘述细节

建议>

有几个需要注意的点

请注意你要部署网站服务器的访问速度和流量，本地图片会占用网站加载时间(别的内容加载完了图片还没加载出来)
建议涉及大量图片的使用图床(例如相册)
网页banner视频建议使用文件大小较小的视频文件，否则加载时间会过长
音乐播放器文档中主API似乎已经失效，可以将备用API的第一项复制替换到主API(网易云音乐解析如果使用私有歌单会播放失败，请使用公开歌单)

贴一张我的awa

构建项目#

提示> 如果你有Nginx等静态网站服务器，此步可以输出静态网站，你可以直接使用此步输出的静态网站。

没有服务器的用户可以跳过此步(输出了没啥用)

在根目录打开终端，输入指令

Terminal window

1
pnpm build

构建完成输出：

你可以在根目录下的dist文件夹中找到生成的静态文件，打包到服务器即可使用

使用Github Pages搭建网站#

账号有关设置#

访问GitHub主网站并注册账号
新建一个项目，项目名填你的用户名.github.io，并点击创建

Git相关配置#

回到项目根目录，右键空白位置打开git bash

打开后分别输入

Terminal window

1
git config --global user.name "你的github用户名"
2
git config --global user.email "你的github绑定邮箱"

接着创建SSH密匙，输入

Terminal window

1
ssh-keygen -t rsa -C "你的github绑定邮箱"

然后一路回车

进入 [C:\Users\用户名\ .ssh] （要勾选显示“隐藏的项目”），用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。

进入github，打开github的设置，选择左边栏的 SSH and GPG keys，点击New SSH key添加密匙

title随便取一个名字，下面的key编辑框粘贴你刚刚复制的内容，最后点击下方的Add SSH Key完成添加

回到Git Bash

输入 ssh -T git@github.com,出现Are you…，输入yes回车即可。

出现如下输出即代表与Github建立了有效链接，可以进行下一步。

部署项目#

在.github/workflows创建deploy.yml文件，并将下面的内容复制进去。

1
name: Deploy to GitHub Pages
2

3
on:
4
  push:
5
    branches: [master]
6
  workflow_dispatch:
7

8
permissions:
9
  contents: read
10
  pages: write
11
  id-token: write
12

13
jobs:
14
  build:
15
    runs-on: ubuntu-latest
16
    steps:
17
      - name: Checkout
18
        uses: actions/checkout@v4
19

20
      - name: Setup pnpm
21
        uses: pnpm/action-setup@v4
22

23
      - name: Setup Node
24
        uses: actions/setup-node@v4
25
        with:
26
          node-version: 22
27
          cache: pnpm
28

29
      - name: Install dependencies
30
        run: pnpm install
31

32
      - name: Build
33
        run: pnpm build
34

35
      - name: Upload artifact
36
        uses: actions/upload-pages-artifact@v3
37
        with:
38
          path: dist
39

40
  deploy:
41
    needs: build
42
    runs-on: ubuntu-latest
43
    environment:
44
      name: github-pages
45
      url: ${{ steps.deployment.outputs.page_url }}
46
    steps:
47
      - name: Deploy to GitHub Pages
48
        id: deployment
49
        uses: actions/deploy-pages@v4

展开收起

接着打开根目录下的astro.config.mjs文件，设置site和base

site:“https://你的用户名.github.io”,

base:”/”

打开你创建的仓库，复制ssh链接，并在终端输入git remote add origin git@github.com:xxx/xxx以连接到github仓库

随后，提交所有变更，在终端输入git add .

接着，创建一次本地提交，在终端输入git commit -m "update"

最后，把本地更改推送到远程仓库，在终端输入git push

完成后，你应该能看github里新增的文件了

随后我们进入构建页面，点击Action

可以看到构建中出现了错误，原因是github pages并没有启用

点击setting，来到设置页面，然后再左侧栏中点击Pages进入页面设置

将源设置为github构建

接着我们回到Actions，进入失败的工作流，点击重新构建

等待工作流构建成功后，回到Setting-Pages，我们可以看到我们网站的网址

访问用户名.github.io

可以看到访问正常，网站成功部署

Tip

修改网站或编写文章后，可以使用pnpm dev预览，接着依次在根目录下执行下列命令可以推送新内容到github实现自动构建自动发布

Terminal window

1
git add .
2
git commit -m "update"
3
git push

扩展内容#

如果你有自己的域名的话，可以去DNS里添加CNAME解析，内容为用户名.github.io

回到GitHub的Pages页，将你的域名输入到编辑框里，点击Save***(如果下方启用https没有勾选请尽量勾选)***

这样你就可以使用自己的域名来访问你的网站了

Hello World

Thu, 01 Jan 2026 00:00:00 GMT

来到astro的第一篇文章