VS Code与TypeScript无法识别assert包的问题排查

问题根源 #

VS Code的TypeScript语言服务无法识别assert模块类型，核心原因有两点：

1. tsconfig的include范围未覆盖测试文件：当前tsconfig.json的include仅指定了./index.ts，测试文件core/library/waitFor.tests.ts不在编译范围内，导致TypeScript服务未为该文件加载@types/node中的类型定义。
2. 环境配置歧义：tsconfig的lib包含dom（浏览器环境），加上测试文件不在编译范围，语言服务默认按浏览器环境解析，忽略了Node.js内置模块的类型。

而tsx能正常运行是因为它执行文件时会自动加载Node.js类型，且不严格遵循tsconfig的include规则。

解决方案 #

方案1：扩展tsconfig的include范围 #

修改tsconfig.json的include字段，将测试相关文件纳入编译范围：

{
  "include": [
    "./index.ts",
    "./library/**/*.ts",
    "./test.ts"
  ]
}

修改后TypeScript语言服务会为这些文件加载@types/node的类型定义，标红问题即可消失。

方案2：为测试文件单独配置tsconfig #

若不想修改主配置，可创建tsconfig.test.json专门处理测试文件：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "lib": ["es2022", "dom", "node"] // 显式添加Node.js环境库
  },
  "include": [
    "./library/**/*.ts",
    "./test.ts"
  ]
}

随后在VS Code中：

• 打开命令面板（Ctrl+Shift+P）
• 执行「TypeScript: Select TypeScript Version」，选择项目本地版本
• 执行「TypeScript: Select tsconfig.json」，选择刚创建的测试配置文件

方案3：确认VS Code使用本地TypeScript版本 #

若VS Code使用全局TypeScript版本，可能无法读取项目本地的@types/node：

• 打开命令面板（Ctrl+Shift+P）
• 选择「TypeScript: Select TypeScript Version」
• 勾选「Use workspace version」（对应项目node_modules中的typescript）

验证 #

修改配置后重启VS Code，打开waitFor.tests.ts，assert的标红提示应消失，同时tsx仍可正常运行测试。

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