VS2019内置TypeScript与npm、gulp所用TypeScript的关系是什么？

为什么会存在两套TypeScript版本 #

• 第一套是项目本地npm安装的版本：你package.json里锁定的^3.9.9属于项目级依赖，存放在node_modules目录下，仅提供给gulp-typescript等项目内npm脚本、工具调用，完全独立于全局或IDE的TypeScript安装，gulp编译时只会读取这个版本的TS编译器，完全不受Visual Studio设置影响。
• 第二套是Visual Studio内置的TypeScript SDK：VS2019延续了旧版本的内置TS逻辑，目的是给不使用npm构建的传统ASP.NET等项目提供开箱即用的TS编译能力，你在项目属性里选择的版本仅给VS自带的TS编译工具、编辑器语法检查、智能提示功能使用，默认不参与npm+gulp的构建流程。

版本不一致是否会产生影响 #

如果你的项目构建完全走gulp-typescript流程，且已经关闭了VS自带的TS生成功能，大部分情况下不会影响最终打包结果，但会出现两个体验问题：

• VS编辑器的语法检查、类型提示使用的是4.2版本的规则，和你实际编译用的3.9.9规则不一致，可能出现编辑器提示报错但实际编译能过，或者编辑器无报错但实际编译失败的错位问题
• 如果不小心开启了VS自带的TS生成功能，会直接用你选中的4.2版本编译代码，和预期的3.9.9编译结果不一致，可能引发生产环境问题

是否需要同时保留两套版本 #

不需要刻意删除任意一套，二者的安装路径、调用逻辑完全隔离：

• VS内置的TS属于IDE级别的组件，删除会影响所有使用VS内置TS能力的项目，不建议卸载
• 项目本地的npm TS版本属于项目级依赖，仅服务于当前项目，删除会直接导致gulp编译失败

如何将二者版本统一 #

你可以配置VS直接调用项目node_modules里的TS版本，操作步骤如下：

1. 右键VS项目选择「卸载项目」，再右键选择「编辑项目文件」
2. 在项目文件的第一个PropertyGroup节点下添加以下配置：

<TypeScriptToolsVersion>Latest</TypeScriptToolsVersion>
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
<TypeScriptBuildEngine>NodeJs</TypeScriptBuildEngine>

3. 保存项目文件后重新加载项目，此时VS会自动识别项目node_modules里安装的3.9.9版本作为编辑器语法检查、智能提示的TS版本，同时关闭VS自带的TS编译功能，完全走gulp构建流程。
   如果需要在VS属性页的版本列表里显示3.9.9，也可以单独下载对应版本的TypeScript SDK for Visual Studio安装，安装后即可手动选中对应版本。

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