本篇文章介绍 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命令。







网友评论