导入viem后出现大量TypeScript编译错误的问题求助

1. 确认TypeScript版本兼容性 #

Viem依赖TypeScript 5.0及以上版本，低版本TS无法正确解析其现代类型定义。执行命令升级：

npm install typescript@^5.0 --save-dev

2. 优化tsconfig.json配置 #

调整compilerOptions参数，匹配Viem的类型要求，同时保留严格模式的核心检查：

{
  "compilerOptions": {
    "target": "ES2020", // 适配Viem的语法特性，最低要求ES2020
    "module": "ESNext", // 根据打包环境可切换为CommonJS
    "lib": ["ES2020", "DOM"], // 包含Viem依赖的标准库类型
    "strict": true,
    "strictFunctionTypes": false, // 关闭此选项以兼容Viem的部分类型约束
    "skipLibCheck": false, // 关闭规避选项，回归根本检查
    "esModuleInterop": true,
    "moduleResolution": "node",
    "resolveJsonModule": true
  }
}

3. 确保Gulp TS任务配置一致 #

在Gulp任务中直接加载tsconfig.json，避免手动覆盖编译器选项导致配置冲突：

const ts = require('gulp-typescript');
const tsProject = ts.createProject('tsconfig.json');

function compileTS() {
  return tsProject.src()
    .pipe(tsProject())
    .js.pipe(gulp.dest('dist'));
}

exports.default = compileTS;

4. 清理依赖缓存 #

若以上步骤无效，清理依赖后重新安装，排除缓存导致的类型异常：

rm -rf node_modules package-lock.json
npm install

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