typescript菜鸟教程 for of（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选项就解决了这个问题
 
 
 
 
 
。

此标志控制导入的工作方式










，有三种不同的选项：

remove：丢弃没有使用的import  
   
   
   
   
   。【默认值】 preserve：保留所有的import                 ，即使从来没有使用过的定义 

 

 

 

 

 
。 error：基本上和preserve选项一致
 
 
 
 
 
 
 
 
 
 
 
，但是















，当值（value）被import仅用作 type 时会报错

 

 

 

 

 

。如果您希望确保没有意外导入任何值            ，此时可以使用此选项           。

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  
  
  
  
  
  ，切换成功           。