JerryLife

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

Sun, 02 Aug 2026 00:00:00 GMT

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

目录#

原理：为什么会拒绝推送
报错速查表：对号入座
non-fast-forward：远程已有新提交
fetch first：本质同源的提示
Permission denied：权限或认证问题
protected branch：分支保护拦截
force push 被拒：改用 force-with-lease
大文件与 hook 拦截
合并冲突：完整解决流程
rebase 冲突：continue / skip / abort
merge 还是 rebase：怎么选
预防冲突的最佳实践
命令速查表

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

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 命令直接写入：

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<在给视频播放软件插帧时需开启>，游戏需关闭。

演示以及效果对比#

测试机型为红米K60 CPU骁龙8gen1+ GPU Adreno 730

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

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 set-url 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的第一篇文章