GitHub Actions执行tsc命令时出现Cannot find module错误排查求助

以下是几个针对性的排查方向：

1. 验证CI环境中目标文件的存在性 #

GitHub Actions构建环境可能没有正确拉取到public/tpot.png文件，可在tsc --noEmit步骤前添加命令检查文件是否存在：

ls -la public/

如果文件不存在，检查：

• .gitignore是否误将public/目录或该图片排除
• 构建流程中是否有前置步骤删除/移动了该文件

2. 检查TypeScript版本与路径别名解析差异 #

本地、Vercel与GitHub Actions的TS版本可能不一致，导致路径别名解析行为不同：

• 在CI步骤中添加命令查看TS版本：

  tsc --version
  

  对比本地版本，若不一致，在CI中指定固定版本的TypeScript（比如通过npm install typescript@x.x.x）
• 确认tsconfig.json的baseUrl和paths配置在CI环境中被正确读取，避免构建脚本覆盖了tsconfig路径

3. 确认图片类型声明文件的有效性 #

TypeScript无法识别图片模块通常是缺少类型声明，检查：

• CI环境中是否存在图片类型声明文件（比如src/types/images.d.ts），且该文件被tsconfig的include数组包含
• 类型声明文件内容是否正确，示例：

  declare module '*.png' {
    const value: string;
    export default value;
  }
  

4. 清理CI环境的缓存 #

GitHub Actions的依赖或编译缓存可能导致异常，尝试在构建前清理缓存：

rm -rf node_modules .next dist
npm install

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