TypeScript+Node.js扩展Express Request接口报错：Property 'user_id'不存在

以下是几个排查和解决的关键点：

1. 修正类型扩展文件的写法 #

如果你的express.d.ts文件中存在import/export语句，TypeScript会将其视为模块文件，此时全局类型扩展需要包裹在declare global中，否则无法合并到Express的全局类型里：

declare global {
  namespace Express {
    interface Request {
      user_id: number;
    }
  }
}

// 必须添加此导出语句，确保文件被识别为模块
export {};

如果文件没有任何import/export，可以保持原写法，但要确保它是全局类型文件。

2. 确保类型文件被编译范围包含 #

检查tsconfig.json的include字段，确认是否覆盖了src/types目录下的类型文件：

"include": [
  "src/**/*"
]

如果include只指定了特定目录（比如src/routes），需要补充src/types/**/*.d.ts，否则TypeScript会忽略这些类型定义。

3. 调整typeRoots的优先级 #

将自定义类型目录放在node_modules/@types前面，确保TypeScript优先加载你的自定义扩展：

"typeRoots": [
  "./src/types",
  "./node_modules/@types"
]

4. 清除TypeScript缓存并重启服务 #

VS Code的TypeScript语言服务可能存在缓存，导致类型更新不生效：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）
• 选择TypeScript: Restart TS Server选项重启服务
• 或者删除项目根目录下的node_modules/.cache（如果存在），重新编译项目

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