Yngaの随记

1. 先把博客代码推到 GitHub#

如果仓库还没建，先在 GitHub 创建一个新仓库，再把本地开发调整好的博客代码推上去。

2. 在 EdgeOne Pages 里新建项目#

登录腾讯云控制台后，进入 EdgeOne Pages，新建一个站点或应用。

第一次用的话，平台通常会引导你选择代码来源。
这里直接选 GitHub 就行。

3. 授权 GitHub 并绑定仓库#

接下来平台会跳转到 GitHub 授权页，让 EdgeOne 读取你的仓库列表。
授权完成后，回到 EdgeOne Pages 页面，选择你刚才推送好的博客仓库。

这里要注意两件事：

1. 仓库选对
2. 分支选对

如果你的正式内容都在 main，那这里就不要手滑选成别的测试分支。
因为 EdgeOne Pages 后面会持续监听这个分支，后续每次推送都会自动触发部署。

4. 把构建设置填正确#

这一段是整篇文章真正的重点。

如果面板提供的是“框架预设”，你可以优先尝试：

• Astro
• 或者 静态网站

如果它没有完全识别对，也没关系，手动把命令改对更重要。

推荐填写方式如下：

1
pnpm i && pnpm build

输出目录填：

1
dist

安装命令：

1
# Install
2
pnpm i

1
# Build
2
pnpm build

5. 等第一次构建完成#

保存配置后，EdgeOne Pages 会开始第一次拉取仓库并构建站点。
第一次部署一般会比后续更新慢一点，这是正常现象。

构建成功后，你通常会拿到一个平台分配的默认访问域名。
这时候先别急着绑定自定义域名，先做一件更重要的事：

直接打开默认域名，确认首页、文章页、静态资源和样式都正常。

我通常会重点检查下面几项：

• 首页是否能正常打开
• 图片资源是否加载正常
• 字体有没有明显丢失
• 页面切换是否正常
• 文章列表和文章详情页是否都能进入

6. 确认自动部署是通的#

第一次部署成功，不代表后面每次更新都一定没问题。
最稳妥的做法是：随便改一点点内容，再推送一次，看 EdgeOne Pages 会不会自动重新构建。

只要这一步是通的，后面你的博客更新流程就会非常顺：

1. 本地写文章或改配置
2. 推送到 GitHub
3. EdgeOne Pages 自动构建
4. 网站自动更新

这也是我比较喜欢这种托管方式的原因之一，维护成本很低。

1. 包管理器填错#

这是最常见的问题，没有之一。

如果你用了：

• npm install
• yarn install

那很可能会在安装阶段直接失败。
对 Mizuki 项目来说，老老实实用 pnpm 是最省事的。

2. 输出目录填错#

Astro 静态站点最后产物是 dist。
如果你把输出目录填成别的，比如 build 或者空着不管，部署成功了也可能访问不到内容。

3. 只看构建成功，不看页面细节#

有时候“构建成功”只是说明命令没报错，不代表页面就完全正常。
尤其是博客这类项目，最好手动点一遍：

• 首页
• 一篇文章
• 导航菜单
• 图片资源
• 自定义域名（如果已经绑定）

4. 把平台问题和项目问题混在一起#

如果你发现 EdgeOne Pages 构建失败，先分两种情况看：

• 本地也构建不过：优先修本地
• 本地能过，平台不过：重点看平台 Node 版本、构建命令、安装方式

这样排查会快很多。