无法将GitHub仓库部署至GitHub Pages及自定义域名问题求助

问题背景 #

• 已切换为GitHub学生账号，绑定Namecheap自定义域名 hedevelope.me
• 创建个人作品集仓库 hedevelope.github.io，需重定向至自定义域名，但页面显示Site not found错误
• GitHub Pages部署日志无异常，但Vercel部署失败，仅Netlify可正常部署（Netlify部署地址：https://bespoke-cuchufli-f038f1.netlify.app/）
• 本地运行曾因报错过多，降级Node版本至6.14.11、npm至14.16.0，并在package.json添加如下配置，但问题仍未解决：

"engines" : { 
  "npm" : "14.16.0",
  "node" : "6.14.11"
}

• 项目基于bchiang7/v4仓库文件

排查与解决方案 #

1. 自定义域名配置校验 #

• GitHub Pages仓库设置：进入hedevelope.github.io仓库的Settings > Pages > Custom domain，确认填写hedevelope.me并勾选Enforce HTTPS（GitHub生成证书需10-30分钟，期间可能无法访问）
• Namecheap DNS解析：清理无关DNS记录，添加以下记录：
  • A记录：主机@，指向GitHub Pages官方IP：185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153
  • CNAME记录：主机www，指向hedevelope.github.io
  • 设置TTL为1分钟，通过nslookup hedevelope.me验证解析是否生效

2. 项目构建配置修正 #

• engines版本兼容修复：你配置的npm14.16.0与Node6.14.11完全不兼容——Node 6对应npm最高为3.10.10，npm 14需要Node 14+。修正package.json：

"engines" : { 
  "node" : "14.16.0",
  "npm" : "6.14.11"
}

• GitHub Pages构建目录设置：bchiang7/v4默认构建输出到build文件夹，需在仓库Settings > Pages > Build and deployment中，将分支对应的文件夹设置为/build；或修改项目配置，将构建输出改为docs目录

3. Vercel部署修复 #

• 指定Node版本：在Vercel项目Settings > General > Node.js Version，手动选择14.x版本，与engines配置匹配
• 构建命令与输出目录：确认Vercel构建命令为npm run build，输出目录设置为build

4. 构建一致性验证 #

• 本地执行npm run build，确认build文件夹生成完整且无报错
• 将build文件夹内容推送到仓库gh-pages分支，尝试从该分支部署GitHub Pages（Settings > Pages > Branch选择gh-pages，文件夹选/）

内容的提问来源于stack exchange，提问作者jsnewbie