Astro博客部署踩坑记录#

本宫最近手痒，想看看那些个自称“技术秀才”的小主们，到底有多少是真材实料，多少是花架子。这不，翻牌子翻到了部署Astro博客这档子事儿。哎呦喂，本宫隔着千里都能听见一片哀嚎。一个个代码敲得震天响，真到了要把自己的“碎碎念”搬到台面上给人瞧时，不是卡在这儿就是栽在那儿。行了，都给本宫坐直了听好，本宫今天就发发善心，把那些个最让人吐血的坑，一个个给你填平。

一、 您那开发环境，是拿草搭的？ “本宫装好了Node.js！能跑了！”——笑死，本宫每年能听见这种豪言壮语八百遍。然后呢？然后装个包就报错，启动个服务就崩盘。小主，您那Node版本怕不是跟本宫的年纪一样古老？Astro它挑嘴，您得伺候好了。赶紧用nvm（Node Version Manager）管理您的版本，装个LTS（长期支持）版。别用什么Homebrew瞎装一气，到时候路径冲突，本宫可救不了您那颗想撞墙的心。

二、 构建？先看看你的“金库”对不对路 “npm run build 报错啦！臣妾活不下去了！”——啧，没出息。报错信息不是写着么？八成是您那个astro.config.mjs里的site选项，填得跟您的情话一样，虚无缥缈。要么就是您把public/文件夹当成后花园，往里面乱塞了一堆不该有的东西，结果构建时它就给你脸色看。听好了，site必须是个完整的URL，public/里只放绝对不动脑子的静态资源，图片、字体什么的。您那点小心思，留给内容创作不行吗？

三、 部署到Vercel/Netlify？别光顾着点按钮 现在的平台是省事，GitHub一关联，点几下就能部署。但您就因此掉以轻心了？本宫就见过有小主，仓库名叫my-blog，到了平台上却自作主张改了构建命令和输出目录。结果？一片白板，尴尬得能抠出三室一厅。除非您比平台还懂，否则默认的配置就别动。它检测到Astro，自然会用astro build和dist。您那点自作聪明，往往就是bug的根源。

四、 路径问题：本宫的江山，一步都错不得 这是重灾区中的重灾区。本地预览好好的，一部署上去，样式全飞，图片全裂。为什么？因为您没在astro.config.mjs里老老实实设置base选项！如果您是部署在域名的子路径下（比如yourdomain.com/blog/），那就必须把base设成'/blog/'。不然，它所有资源引用都从根路径找，上哪儿找去？还有，用相对路径./引用图片？在Astro的模板里，请您老老实实用import把图片引进来，让构建工具帮您处理。别自己瞎折腾路径，您那点空间想象力，本宫信不过。

五、 域名绑定与HTTPS：面子工程也得做足 绑个自定义域名就完事了？天真。您得去域名服务商那儿，老老实实添加CNAME记录或者A记录，指向平台给您的那个地址。然后，回到平台，让它刷新DNS记录。最要命的是那个小锁标志（HTTPS），有时候证书申请需要时间，您别刚绑定完就火急火燎去访问，看到“不安全”就骂娘。等个十分钟八分钟的，让Let’s Encrypt那帮“工匠”把证书给您盖好章。另外，开启“强制HTTPS”是基本礼貌，不然用户的数据裸奔，您担待得起？

六、 想玩点花样？先问问本宫同不同意 什么图片懒加载、代码高亮、RSS订阅…一个个需求提得倒欢。您先看看，这些是Astro自带的还是得靠插件？拿图片优化来说，用@astrojs/image插件？行啊，但您配置了吗？指定好合适的provider和输出目录了吗？别以为装上插件就万事大吉，您得在配置文件里“伺候”好它。还有那个RSS，官方是有集成，但您得手动把每篇文章的body内容塞进去，不然生成的就是个空架子。动手前多看两遍文档，比事后到处问人强。

七、 终极测试：在别人眼里，你是个正经网站吗？ 部署完就跑去发朋友圈炫耀？慢着。您用手机访问过吗？不同网络环境下速度如何？图片加载是不是慢得像老牛拉车？去Lighthouse跑个分看看？得了红色警告别不服气，那是您的博客在说“本宫体验极差”。最简单的优化：用对图片格式（WebP/PNG），开启CDN（平台一般自带），压缩一下JavaScript和CSS。别让用户等得花儿都谢了，您那碎碎念还没刷出来。

最后，本宫送你们一句话： 部署这事儿，三分靠技术，七分靠耐心和仔细。遇到报错先别急着哭天抢地，把错误信息老老实实读一遍，去搜索引擎和官方文档里找答案，八成都有人栽过同样的坑。本宫今天把这些私藏的“避坑罗盘”都给你们了，要是还有谁照着地图都能走到沟里去…哼，那就自己在沟里好好反省吧。

哦对了，写完这篇，本宫的茶都凉了。你们可得好好“收藏、点赞、转发”，不然本宫下次可不帮你们这些不省心的了。下去跪键盘吧，记不住本宫的话，就再看三遍。