Deno-TS类型识别异常：数组被判定为空对象{}

问题现象 #

在VS Code中使用Deno开发时，类型检查出现异常：

• 自定义类型数组（如Author[]）、基础类型数组（如string[]）均被错误识别为{}类型
• 访问数组属性（如length）会触发类型错误提示，但代码实际可正常编译运行

现有配置 #

项目根目录deno.json #

{
    "compilerOptions": {
        "lib": [
            "DOM"
        ]
    },
    "imports": {
        "@std/path": "jsr:@std/path@^1.0.8"
    }
}

项目根目录tsconfig.json #

{
  "compilerOptions": {
    "target": "ES2023",
    "module": "ES2022",
    "moduleResolution": "bundler",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true
  }
}

.vscode/settings.json #

{
    "deno.enable": true,
    "deno.lint": true
}

解决方法 #

1. 移除独立tsconfig.json，合并配置到deno.json #

Deno自带完整的TypeScript工具链，根目录的tsconfig.json会干扰Deno的类型检查逻辑。将tsconfig.json中的编译选项合并到deno.json的compilerOptions中，然后删除tsconfig.json：

修改后的deno.json：

{
    "compilerOptions": {
        "lib": ["DOM"],
        "target": "ES2023",
        "module": "ES2022",
        "moduleResolution": "bundler",
        "esModuleInterop": true,
        "forceConsistentCasingInFileNames": true,
        "strict": true,
        "skipLibCheck": true
    },
    "imports": {
        "@std/path": "jsr:@std/path@^1.0.8"
    }
}

2. 强制VS Code使用Deno的TypeScript服务 #

调整.vscode/settings.json，禁用内置TypeScript服务，确保使用Deno提供的TS SDK：

{
    "deno.enable": true,
    "deno.lint": true,
    "typescript.enablePromptUseWorkspaceTsdk": false,
    "typescript.tsdk": ""
}

或者直接指定Deno的TS SDK路径（路径根据Deno安装位置调整）：

{
    "deno.enable": true,
    "deno.lint": true,
    "typescript.tsdk": "${userHome}/.deno/lib/typescript/lib"
}

3. 重启VS Code的TypeScript服务 #

按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板，输入TypeScript: Restart TS Server并执行，让配置变更生效。

原因说明 #

Deno的类型检查器与标准TypeScript服务存在配置兼容问题，当根目录同时存在deno.json和tsconfig.json时，VS Code可能默认使用内置TS服务而非Deno的类型检查器，导致数组类型推断异常；此外，VS Code的TS服务未正确切换到Deno SDK也会引发此类智能提示错误。

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