TypeScript项目中node:process无dlopen类型定义致tsc编译失败求助

1. 对齐@types/node版本 #

你当前Node.js版本是18.14.0，但安装的@types/node是20.6.5，版本不匹配极易导致类型定义与运行时API不一致。先卸载现有包，安装对应大版本的类型依赖：

npm uninstall @types/node
npm install @types/node@18 --save-dev

如果安装后仍无dlopen的类型定义，再使用下面的自定义类型补全方案。

2. 手动补全类型（推荐） #

在项目中创建types/node.d.ts文件，手动扩展node:process模块的类型定义：

declare module 'node:process' {
  export function dlopen(
    module: object,
    filename: string,
    flags?: number
  ): void;
}

随后确保tsconfig.json的include字段包含该类型文件路径：

{
  "include": [
    "src/**/*",
    "types/**/*"
  ]
}

配置完成后，TypeScript即可识别dlopen的类型，编译报错会消失。

3. 临时绕过类型检查 #

若仅需临时解决问题，不想编写类型定义，可通过类型断言跳过TypeScript的检查：

import process from 'node:process';
const dlopen = (process as any).dlopen;

// 或直接在调用时断言
(process as any).dlopen(module, './addon.node');

此方法虽简单，但会丢失类型检查的优势，仅适合临时场景使用。

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