今天做了什么
- 仓库检查 .gitignore 后首次推送 GitHub(Ourwlsg/demoSpace):补上
.codegraph/ 本地索引和系统垃圾文件两条遗漏。
- Cloudflare Pages 连接 GitHub 仓库完成部署,站点上线:demospace-7j9.pages.dev。
- 全链路验证:改
astro.config.mjs 的 site 为真实域名 → push → Cloudflare 自动重新部署 → sitemap 域名确认无误。“push 即发布”正式生效。
过程与坑
- 新版 Cloudflare 控制台没有原来的 Workers & Pages 入口,Pages 的 Git 部署入口藏在「Create a Worker」页面底部的一行小字 “Looking to deploy Pages? Get started” 里,官方文档的路径描述已经过时。
- 创建时默认走进 Workers 流程(部署到 workers.dev 且需要 wrangler 配置),要及时退出来走 Pages。
demospace 在 pages.dev 上已被别人注册,免费子域名全球唯一,实际分配到带后缀的 demospace-7j9.pages.dev。
- 构建关键参数:Root directory 填
site(Astro 工程在子目录)、Build pnpm build、输出 dist、环境变量必须加 NODE_VERSION=22(Pages 默认 Node 太旧,Astro 7 要求 >=22.12)。
- 自定义域名 demospace.com 需要先把 DNS 的 NS 迁到 Cloudflare,暂缓,先用免费域名。
下一步
- 内容侧待办:作品页补真实踩坑记录;开源收藏剩余深度报告分批生成。