本篇文章介绍 TypeScript 的安装以及使用,不介绍 TypeScript 语法。
在 CLI 中使用
本地安装 TypeScript
npm i -D typescript
在项目根目录中创建配置文件 tsconfig.json
{
"compilerOptions": {
"module": "system",
"noImplicitAny": true,
"removeComments": true,
"preserveConstEnums": true,
"outFile": "../../built/local/tsc.js",
"sourceMap": true
},
"files": ["core.ts", "types.ts"],
"include": [
"src/**/*"
],
"exclude": [
"node_modules",
"**/*.spec.ts"
]
}
-
tsconfig.json
文件可以是个空文件,那么会以默认配置选项编译。 - 在命令行上指定的编译选项会覆盖在
tsconfig.json
文件里的相应选项。 -
"compilerOptions"
可以被忽略,这时编译器会使用默认值。在这里查看完整的编译器选项列表。 -
"files"
指定一个包含相对或绝对文件路径的列表。 -
"include"
和"exclude"
属性指定一个文件glob匹配模式列表。 - 如果不指定
"exclude"
,默认情况下会排除node_modules
,bower_components
,jspm_packages
和<outDir>
目录。 - 如果
"files"
和"include"
都没有被指定,默认包含当前目录和子目录下所有的.ts
,.d.ts
和.tsx
文件( 如果allowJs
设置为true
还包含.js
和.jsx
)。 - 如果一个 glob 模式里的某部分只包含
*
或.*
,那么只包含.ts
,.d.ts
和.tsx
文件扩展名(如果allowJs
设置能true
还包含.js
和.jsx
)。 - 任何被
"files"
或"include"
指定的文件所引用的文件也会被包含进来。 - 默认情况下
node_modules/@types
文件夹下以及子文件夹下的所有@types
包会在编译过程中被包含进来。 - 指定
"types": ["node", "lodash", "express"]
只有被列出来的@types
包才会被包含进来。 - 配置文件里的相对路径在解析时相对于配置文件所在的目录。
执行 CLI 命令
# 根据配置文件 tsconfig.json 提供的信息来编译相关的文件
npx tsc
# 当命令行上指定了具体文件时,tsconfig.json 文件会被忽略
npx tsc src/index.ts
在 VSCode 中使用
- VSCode 编辑器自带 typescript 语法以及类型检测功能,无需安装任何插件,也无需安装
typescript
,无需编写tsconfig.json
配置文件。 - 在编辑器中编写代码,会自动进行 typescript 语法以及类型检测(无需运行 CLI 命令),出错的地方会有白色的波浪线。
- VSCode 编辑器只能进行语法以及类型检测,无法编译 ts 文件,如果需要编译,需要安装
typescript
,并编写tsconfig.json
配置文件,然后在命令行中执行npx tsc
命令。
网友评论