TypeScript选项‘importsNotUsedAsValues‘和‘preserveValueImports‘弃用

TypeScript 从5.0开始，选项“importsNotUsedAsValues”和“preserveValueImports”已经被标记为Deprecated，并将在TypeScript5.5之后停止支持，可以使用“verbatimModuleSyntax”选项替代。

默认情况下，假如你在TypeScript中写下如下代码：

import { Car } from "./car";
export function drive(car: Car) {
  // ...
}

TypeScript检测到您只对类型定义导入，就会完全删除导入。输出的JavaScript可能如下：

export function drive(car) {
  // ...
}

如果 ./car 文件中仅仅定义了type 或者interface，转换为javascript时这些定义被抛弃，是正确。但是，如果 ./car中的Car是一个class，里边还包括了一些其他定义。这个文件被抛弃。最终的javascript可能会产生Runtime error。

importsNotUsedAsValues选项就解决了这个问题。

此标志控制导入的工作方式，有三种不同的选项：

preserveValueImports作用：

例如：

import { Animal } from "./animal.js";
eval("console.log(new Animal().isDangerous())");

这样的代码编译器不知道是否该保留还是该抛弃。如果想保留，请使用preserveValueImports选项

importsNotUsedAsValues、preserveValueImports还有一个isolatedModules共三个选项，比较难以理解，有时候使用时仍旧有一些边缘情况导致非期盼的结果。

从TypeScript5.0开始，引入了verbatimModuleSyntax选项（值为 true，false）。使用type修饰符，就明确保留还是抛弃，以简化以上情况。

// This statement can be dropped entirely in JS output
import type * as car from "./car";
// The named import/export 'Car' can be dropped in JS output
import { type Car } from "./car";
export { type Car } from "./car";
// Erased away entirely.
import type { A } from "a";
// Rewritten to 'import { b } from "bcd";'
import { b, type c, type d } from "bcd";
// Rewritten to 'import {} from "xyz";'
import { type xyz } from "xyz";

使用此选项后，实现了所见即所得。有type修饰符的，明确只使用了定义，编译时直接抛弃；没有使用type修饰符的，编译时就会保留其内容。

一般情况下，vscode会首先使用自带的TypeScript版本。最近升级后TypeScipt默认都会是5.X版本。

如果想继续使用5.x版本，增加一个选项：
在tsconfig.json 中增加 "ignoreDeprecations": "5.0"，就不再报警了。

项目如果想切换到4.X版本：

切换TypeScript版本：首先确保在本项目已经有TypeScript4.x
如果没有可以 npm install typescript @4.9
然后

第一种方法：快捷键：Ctrl + Shift + P 然后输入 Typescript: Select Typescript Version，选择本项目的版本。
第二种方法：打开一个ts或者tsx文件。右下角有TypeScript JSX字样，在左边的{ }上，鼠标悬停，在弹窗中点击目前的TypeScript版本。然后会让选择新的TypeScript版本。

OK，切换成功。

标签 , ,

发表回复