从零搭个人技术博客：我踩过的坑

为什么要自己搭

现成平台够用，但定制空间有限：主题、写作流、数据归属都不自由。
我想要一个完全在自己磁盘上的项目（D:\blog），代码、文章、配置都在一起。

第一坑：内容和代码搅在一起

一开始把示例页和业务逻辑混放，改样式时经常误伤文章路由。
后来固定约定：

路径	职责
content/posts/	只放 Markdown 文章
src/app/	路由与页面
src/lib/	读文章、数据库、站点配置
public/	图片与静态资源

经验： 先定目录边界，再堆功能，返工会少很多。

第二坑：主题看起来变了，卡片没变

全站 data-theme 切换后，背景变了，但封面 SVG 里写死了深紫霓虹色。
看起来就像「主题没生效」。

解决办法：列表封面改用 CSS 变量驱动的组件，不要依赖写死颜色的装饰图。

第三坑：本地开发 ≠ 本地生产

npm run dev 热更新很爽，但和 npm run build && npm start 行为不完全一样。
写文章接口、环境变量、静态生成都要在生产模式再验一遍。

小结

• 目录清晰 > 功能堆砌
• 主题色走 CSS 变量，别写死在资源文件里
• 本地也要会「生产部署」

下一篇会写：把文章接到 MySQL 之后，读写与备份怎么做。