Github Actions中TypeScript集成Razorpay模块找不到问题求助

问题场景 #

本地开发时已安装razorpay模块，TypeScript代码运行正常，但推送到GitHub后，GitHub Actions执行构建或测试步骤时抛出错误：cannot find module 'razorpay' or its corresponding type declarations。手动创建rozorpy.d.ts声明文件后，问题仍未解决。

解决方案 #

1. 修正声明文件拼写错误 #

你创建的声明文件名是rozorpy.d.ts，但模块名是razorpay，拼写不一致会导致TypeScript无法识别。将文件名改为razorpay.d.ts即可解决这个低级错误。

2. 安装官方类型声明包（推荐） #

手动编写空声明文件无法提供完整类型支持，且容易出错。razorpay有官方维护的类型包，直接安装即可：

npm install --save-dev @types/razorpay
# 若使用yarn
yarn add -D @types/razorpay

安装后，TypeScript会自动识别node_modules中的类型声明，无需手动创建.d.ts文件。

3. 确保TypeScript配置正确识别文件 #

检查tsconfig.json的配置，确保类型文件或源码目录被正确包含：

{
  "compilerOptions": {
    "moduleResolution": "node", // 确保Node模块解析逻辑生效
    // 其他编译配置...
  },
  "include": ["src/**/*", "razorpay.d.ts"] // 若保留手动声明文件，需添加到include列表
}

如果使用官方类型包，只需确保node_modules在TypeScript的默认解析范围内即可。

4. 检查GitHub Actions的依赖安装步骤 #

确保CI环境中完整安装了所有依赖（包括开发依赖）：

• 若使用npm ci，需确保package-lock.json已提交到GitHub，该命令会严格按照锁文件安装所有依赖（含devDependencies）。
• 若使用npm install，默认会安装package.json中声明的所有依赖。

示例GitHub Actions工作流片段：

steps:
  - uses: actions/checkout@v4
  - name: 安装依赖
    run: npm ci
  - name: 构建TypeScript项目
    run: npm run build

5. 确认依赖已提交到Git #

检查package.json中是否包含razorpay（在dependencies字段）和@types/razorpay（在devDependencies字段），并确保package.json和锁文件（package-lock.json或yarn.lock）已提交到仓库。

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