Astro 主题定制:从 fork 到自己改

398 字
2 分钟
Astro 主题定制:从 fork 到自己改

🍴 fork 之后#

现在的做法是 fork 一份开源主题,然后按自己的意思改。

一开始什么都想改:布局、组件、动画。改了两周之后发现一个问题——上游更新了,我不敢同步了。

🧭 一条实用的原则#

后来我给自己定了条规矩:

能改配置就不改代码,能改代码就不改结构。

主题通常把可定制的部分抽到了 src/config/ 下,几十个配置文件。站点信息、导航、侧边栏、评论、相册、字体、特效……能在这里改的,绝不碰源码。

只有配置里没有的东西(比如某个组件的行为),才去动组件——而且尽量小改,加开关,而不是重写。

🔀 同步上游的正确姿势#

改得越多,同步越痛。三个建议:

  1. 个性化全部收敛到配置文件,别散落在组件里
  2. 不要删上游的功能文件,用开关关掉就好
  3. 定期同步,别攒几个月——攒得越久冲突越难解

真到了冲突那一步,策略是:以上游新版为基底,把你的个性化值一个个覆盖回去。听起来麻烦,做起来其实很机械。

🪵 一点体会#

用开源主题不是”拿来主义”,是在别人的地基上盖自己的房子。

别人给的地基很扎实,这没什么可羞耻的;你要做的是让它长成你的样子,而不是为了证明自己会写代码,把地基重新挖一遍。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Astro 主题定制:从 fork 到自己改
https://shudong.cyou/posts/astro-theme/
作者
树洞
发布于
2026-10-21
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
树洞
shudong · 把想说的话,说给树洞听
公告
欢迎来到树洞 —— 一个安静说话的地方。
分类
标签
最新动态
站点统计
文章
27
分类
5
标签
28
总字数
9,570
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Cloudflare Workers
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录