You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VSCode不识别TypeScript类型声明 仅保存.d.ts文件后生效

VSCode不主动识别TypeScript类型声明的解决方案

可按以下步骤逐一排查解决:

  • 确认VSCode使用工作区版本的TypeScript
    打开任意.ts/.tsx文件,点击编辑器右下角的TypeScript版本号,在弹出的选择框中选择「使用工作区版本」,确保版本号和项目package.json中声明的typescript@4.3.5匹配,选择完成后VSCode会自动重启TS语言服务,验证问题是否修复。
  • 补充tsconfig.json的配置
    首先删除你现有tsconfig.json中include数组末尾多余的逗号,避免配置解析异常。
    其次在compilerOptions字段中添加typeRoots配置,显式指定声明文件的扫描路径,示例如下:
    "compilerOptions": {
      // 其余原有配置保持不变
      "typeRoots": ["node_modules/@types", "src/types"]
    }
    
    上述配置中的src/types替换为你自己项目里存放自定义.d.ts文件的实际目录即可。
  • 清理缓存重启服务
    按Ctrl+Shift+P(Mac系统为Command+Shift+P)调出命令面板,输入「TypeScript: 重启TS服务器」执行,等待服务重启后验证效果。如果仍未解决,删除项目根目录下的node_modules/.cache文件夹,重启VSCode再试。
  • 检查路径大小写匹配
    TypeScript编译器对路径大小写敏感,确认你存放.d.ts文件的目录、文件名的大小写,和tsconfig中include配置的路径规则完全匹配,避免因大小写不一致导致扫描遗漏。

内容的提问来源于stack exchange,提问作者Logan Murphy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 22:24:02