这一章不是虚构的练习,而是一次真实复盘:一个 20 个工具、约 10 万行访问的在线工具站 是怎么从一句"给博客读者做点小工具"长出来的。你会看到每个关键决策是怎么做的、踩了哪些坑、 哪些功夫被证明是白费的。看完你完全可以照着做自己的版本。
✅ 前置要求:已完成主页教程(会建仓库、传文件)+ 实战 1(Pages 建站)。会用 AI 编程工具更佳。工具站的起点不是"我要做个大网站",而是一个小到不能再小的念头:
注意这个起点有三个特征,这决定了项目能不能活下去:
做工具站前必须回答一个问题:数据在哪处理?这决定了整个项目的命运。
HTML + CSS + JS,无需后端
需要服务器 / 数据库
选一个最简单的入手——推荐 JSON 格式化,30 行代码就能用,而且立刻能自测对错。
别急着做"工具集框架"。就一个 index.html,一个工具,能用为先。案例里的做法是后来才抽象出"标签页切换"的——当你有第 3 个工具时再抽象,抽象时机才对。
JSON 格式化的核心就一句 JSON.parse + JSON.stringify。但让用户"愿意再来",靠的是:错误提示告诉用户错在第几行、按钮点击有反馈、输入框会自动聚焦。这些"体验细节"才是工具站的护城河。
让 AI 生成第一版代码完全没问题,但有两件事必须自己做:① 每个功能亲手测一遍边界情况(空输入、超长输入、中文、emoji);② 安全底线自己把关——凡是把用户输入显示到页面上的地方都要防 XSS,案例里用 DOMPurify 过滤了所有富文本渲染。
工具站之间的差距,90% 在这些看不见的地方。按投入产出比排序:
跟随系统 prefers-color-scheme 自动切换,用户手动选过就记住(localStorage)。这是现代网页的"及格线"。
加一个几十行的 Service Worker,用户第二次访问后断网也能用。注意一个新手必踩的坑:改了代码必须递增缓存版本号,否则老用户永远拿到旧文件——案例作者忘过不止一次。
键盘能操作(Tab + 方向键切换工具)、状态提示用 aria-live、触控目标别小于 32px、数字用等宽字体(时间戳跳动不抖)。这些单看都是小事,加起来就是"这个站很专业"的体感。
仓库 Settings → Pages → 选 main 分支。1 分钟上线,够用很久。
买个域名(几十元/年),DNS 加一条 CNAME 指向你的 Pages 地址。从此 tools.你的域名.top 就是工具站入口,还自带 CDN。
Vercel 免费、推代码自动部署、支持 Serverless——案例的工具站后期就是这样迁的,顺带把博客、教程、其他工具全部挂成 xxx.你的域名 的子域名,形成自己的"产品矩阵"。
grep github.io 抓出了 5 处遗漏。真实复盘的价值在踩坑。以下每条都有真实代价:
现在轮到你了。你的第一个工具是什么?任何你手动重复过三次的操作,都值得变成一个页面。