如何配置VSCode使其自动插入import语句时忽略dist文件夹

项目背景 #

我的TypeScript项目源码位于src文件夹下，结构如下：

src
 +-components
 | +-Thing.ts
 | +-Widget.ts
 +-libs
   +-Utils.ts

TypeScript编译后的输出文件会生成到dist文件夹，结构为：

dist
 +-components
 | +-Thing.d.ts
 | +-Widget.d.ts
 +-libs
   +-Utils.d.ts

已经将dist加入.gitignore，但VSCode自动插入import语句时，会错误引用dist路径。比如输入const v: SomeClassInUtils后，VSCode自动生成的import是：

import { SomeClassInUtils } from "../../dist/lib/utils"

而非正确的：

import { SomeClassInUtils } from "../lib/utils"

解决方法 #

1. 配置TypeScript排除dist目录 #

在项目根目录的tsconfig.json中，通过exclude字段将dist目录排除，让TypeScript语言服务不扫描该目录下的类型文件：

{
  "compilerOptions": {
    "outDir": "./dist", // 确保已配置输出目录
    // 其他编译配置...
  },
  "exclude": ["node_modules", "dist"]
}

2. 让VSCode文件系统忽略dist（可选） #

在项目的.vscode/settings.json中添加配置，让VSCode在文件浏览、搜索等场景中忽略dist目录，进一步减少干扰：

{
  "files.exclude": {
    "dist/**": true
  }
}

3. 重启TypeScript语言服务 #

完成上述配置后，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server并执行，让配置生效。

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