Visual Studio 2017 TypeScript智能感知不识别tsconfig.json的baseUrl

我之前帮不少开发者解决过这个VS2017特有的TypeScript智能感知问题——明明构建正常、其他编辑器也能正确识别baseUrl路径，但VS2017的智能感知就是报错。结合你的配置和描述，下面是几个经过验证的解决方案：

1. 确保Visual Studio使用项目本地的TypeScript版本 #

VS2017自带的TypeScript版本通常比较老旧，对baseUrl的支持存在局限性。你可以这么操作：

• 打开工具 > 选项 > 文本编辑器 > JavaScript/TypeScript > 语言服务
• 勾选使用项目版本的TypeScript服务（前提是你的项目已经通过npm安装了TypeScript，比如npm install typescript --save-dev）
• 确认当前选中的TS版本至少是2.0以上，最好和你项目依赖的版本匹配

2. 给tsconfig.json添加paths映射 #

有时候VS2017的智能感知需要明确的路径映射才能识别baseUrl，即使你已经配置了baseUrl。在compilerOptions里补充paths配置：

{
  "compilerOptions": {
    "noImplicitAny": false,
    "noEmitOnError": true,
    "strictNullChecks": true,
    "removeComments": false,
    "sourceMap": true,
    "target": "es5",
    "module": "amd",
    "moduleResolution": "node",
    "baseUrl": "./Content/ts",
    "paths": {
      "*": ["*"]
    }
  },
  "exclude": ["node_modules"],
  "compileOnSave": true
}

这个通配符配置会告诉VS2017的语言服务，所有模块都从baseUrl指定的路径下查找，能有效弥补智能感知对baseUrl的识别缺陷。

3. 重置Visual Studio的TypeScript语言服务缓存 #

语言服务的缓存可能导致配置更新不生效，你可以这么重置：

• 关闭所有Visual Studio窗口
• 删除项目根目录下的隐藏.vs文件夹（这个文件夹里存的是VS的缓存文件）
• 重新打开项目，等待语言服务重新加载配置
• 如果你的VS版本支持，也可以按Ctrl+Shift+P打开命令面板，执行TypeScript: Restart TS Server命令（部分版本可能需要安装相关扩展）

4. 检查csproj文件的冲突配置 #

虽然你已经设置了<TypeScriptBaseUrl>，但还要确保csproj里没有其他冲突的配置：

• 确认<TypeScriptModuleResolution>的值和tsconfig.json里的moduleResolution: node一致
• 检查是否存在<TypeScriptCompileBlocked>配置，如果设置为true会影响智能感知的解析，建议设为false

这些方法都是针对VS2017的TypeScript语言服务特性设计的——毕竟VS2017的TS服务实现和后续版本（比如VS2019+）以及VS Code、Rider有差异，这也是为什么其他编辑器能正常工作的原因。

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