如何让TypeScript识别Electron扩展的全局process对象类型？

当在Electron主进程代码中使用process.type时，TypeScript默认只会识别Node.js原生的Process接口，导致出现TS2339: Property 'type' does not exist on type 'Process'错误。以下是标准的解决步骤：

1. 确保Electron类型定义可用 #

• 若使用Electron 16+版本：Electron自带TypeScript类型定义，无需额外安装依赖。
• 若使用旧版本：手动安装Electron类型包：

  npm install --save-dev @types/electron
  

2. 配置tsconfig.json加载Electron类型 #

通过调整TypeScript配置文件，让工具链优先加载Electron扩展的Process接口：

方法一：指定types字段 #

在tsconfig.json的compilerOptions中添加types数组，明确包含electron，确保Electron的类型定义被加载：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "types": ["electron"],
    // 其他编译配置...
  },
  "include": ["./src/main/**/*"] // 仅包含主进程代码，避免类型混淆
}

方法二：配置typeRoots路径 #

如果类型文件存放在自定义目录，可通过typeRoots指定搜索路径：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./node_modules/electron/types"],
    // 其他编译配置...
  }
}

3. 自定义类型声明（可选） #

如果需要更精确的环境控制，可以创建自定义类型声明文件（比如main-process.d.ts），手动扩展Process接口：

declare namespace NodeJS {
  interface Process {
    type: 'browser' | 'renderer';
    // 按需添加其他Electron扩展属性
  }
}

然后在tsconfig.json的include中引入该文件：

"include": ["./src/main/**/*", "./main-process.d.ts"]

验证生效 #

配置完成后，重启VS Code的TypeScript服务（快捷键Ctrl+Shift+P，选择TypeScript: Restart TS Server），此时process.type的类型错误应该会消失，TypeScript将正确识别Electron扩展的全局process对象。

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