Vercel部署Gitfolio静态项目时自定义构建卡住如何解决？

你当前遇到的构建卡住是因为gitfolio run是本地开发预览命令，作用是启动常驻的HTTP服务器提供页面访问，不会自动终止运行，而Vercel构建阶段要求执行的命令完成静态文件生成后主动退出，所以会一直卡在服务启动的日志位置。

方案1：走标准构建流程部署 #

• 首先修改项目package.json的scripts配置，新增build命令，用来生成静态产物：

"scripts": {
    "cli": "OUT_DIR='./dist' node bin/gitfolio.js",
    "clean": "rm -rf ./dist/*",
    "prettier": "prettier --write \"./**/*.{js,jsx,json,html,css,md}\"",
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "gitfolio build 你的GitHub用户名"
}

• 打开Vercel项目的设置页，修改构建配置：
  • 构建命令填写npm run build
  • 输出目录填写dist
    保存后重新触发部署即可，构建阶段会自动生成所有静态文件到dist目录，Vercel会自动识别目录下的index.html作为首页。

方案2：直接部署预生成的静态文件 #

如果你已经在本地提前执行build命令生成了完整的静态文件（包含index.html、样式、脚本等所有资源），可以直接将静态文件所在的目录作为部署根目录，不需要配置构建命令，Vercel默认会自动加载根目录下的index.html作为站点入口。

如果需要手动指定路由规则，可以在项目根目录新增vercel.json文件，写入以下配置：

{
  "routes": [
    { "src": "/(.*)", "dest": "/index.html" }
  ]
}

这个配置会将所有请求都指向index.html，适配单页应用的路由规则。

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