Evidence项目部署Github Pages时上传构建产物失败的解决方案

在使用Evidence项目进行数据可视化开发时，许多开发者会选择将其部署到Github Pages上。然而，在实际操作过程中，可能会遇到构建产物上传失败的问题，错误提示显示"tar: build/DataViz-for-Indian-Cities: Cannot open: No such file or directory"。

问题现象

当执行Github Actions工作流进行部署时，在"Archive artifact"阶段会出现构建产物无法找到的错误。具体表现为：

1. 项目能够成功构建，生成的文件位于"./build"目录
2. 但在上传构建产物阶段，系统尝试访问"build/项目名称"路径时失败
3. 最终导致部署流程中断

问题根源

这个问题源于Evidence项目的构建输出路径配置与Github Pages部署工作流的预期路径不匹配。Evidence默认会将构建产物输出到项目根目录下的build文件夹中，而部署工作流则尝试在build/项目名称路径下寻找产物。

解决方案

方法一：修改package.json配置

最推荐的解决方案是在package.json文件中明确指定构建路径。在项目的package.json文件中，找到build脚本，添加base路径参数：

"scripts": {
  "build": "evidence build --base /项目名称/"
}

这样配置后，Evidence会将构建产物正确地输出到预期的路径下，与Github Pages部署工作流的预期路径匹配。

方法二：调整Github工作流配置

如果不想修改package.json文件，也可以选择调整Github工作流配置。在部署工作流文件中，修改上传构建产物的路径：

- name: Upload artifact
  uses: actions/upload-pages-artifact@v3
  with:
    path: 'build/'  # 直接指定build目录而非build/项目名称

这种方法直接改变了工作流查找构建产物的位置，使其与Evidence默认的输出路径一致。

最佳实践建议

1. 对于长期维护的项目，建议采用第一种方法，因为这样配置更明确，也便于其他开发者理解项目结构
2. 在团队协作环境中，应在项目文档中明确说明构建产物的输出路径
3. 部署前可在本地运行构建命令，检查build目录结构是否符合预期
4. 对于复杂的项目结构，可以考虑使用Evidence提供的其他构建选项进行更精细的控制

通过以上解决方案，开发者可以顺利解决Evidence项目部署到Github Pages时的构建产物上传问题，确保数据可视化项目能够正常发布和访问。