如何始终忽略TypeScript错误且无实际错误时不触发报错？

问题根源 #

开发环境下，./dist/server/entry/entryServer.js 还没编译生成，TypeScript会提示「找不到模块」；但添加 // @ts-expect-error 后，生产环境该文件存在时，TypeScript又会因为「预期存在错误但实际无错误」抛出警告。需要一种能自适应两种场景的处理方式。

方案一：用 // @ts-ignore 替代 // @ts-expect-error #

// @ts-ignore 会直接忽略当前行的所有TypeScript错误，不管实际有没有错误，刚好适配这种「有时有错误、有时没错误」的场景。注意仅在确认该导入的类型不影响整体代码类型安全时使用。

修改后的代码：

const render = await (async () => {
  if (viteDevServer) {
    return (await viteDevServer.ssrLoadModule('./src/entryServer.ts')).render
  }

  // @ts-ignore File may not be compiled in development
  return (await import('./dist/server/entry/entryServer.js')).render
})()

方案二：类型断言+预定义类型（更严谨） #

如果想保留类型检查，先定义和entryServer.ts导出的render一致的类型，再用类型断言告诉TypeScript导入结果符合该类型，既跳过「模块不存在」的错误，又能保证类型正确。

修改后的代码：

// 提前定义render函数的类型，和src/entryServer.ts里的render类型对齐
type RenderFunction = typeof import('./src/entryServer.ts').render;

const render = await (async () => {
  if (viteDevServer) {
    return (await viteDevServer.ssrLoadModule('./src/entryServer.ts')).render as RenderFunction;
  }

  // 用类型断言跳过模块不存在的检查，同时约束类型
  return (await import('./dist/server/entry/entryServer.js')).render as RenderFunction;
})()

这种方式下，生产环境文件存在时，TypeScript会验证导出的render是否匹配预定义类型；开发环境文件不存在时，类型断言会跳过模块检查，不会报错。

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