与构建工具集成

Babel

安装

sh
npm install @babel/cli @babel/core @babel/preset-typescript --save-dev

.babelrc

js
{
"presets": ["@babel/preset-typescript"]
}

使用命令行界面

sh
./node_modules/.bin/babel --out-file bundle.js src/index.ts

package.json

js
{
"scripts": {
"build": "babel --out-file bundle.js main.ts"
},
}

从命令行执行 Babel

sh
npm run build

Browserify

安装

sh
npm install tsify

使用命令行界面

sh
browserify main.ts -p [ tsify --noImplicitAny ] > bundle.js

使用 API

js
var browserify = require("browserify");
var tsify = require("tsify");
browserify()
.add("main.ts")
.plugin("tsify", { noImplicitAny: true })
.bundle()
.pipe(process.stdout);

更多详情:smrq/tsify

Grunt

使用 grunt-ts(已不再维护)

安装

sh
npm install grunt-ts --save-dev

基本的 Gruntfile.js

js
module.exports = function (grunt) {
grunt.initConfig({
ts: {
default: {
src: ["**/*.ts", "!node_modules/**/*.ts"],
},
},
});
grunt.loadNpmTasks("grunt-ts");
grunt.registerTask("default", ["ts"]);
};

更多详情:TypeStrong/grunt-ts

使用 grunt-browserify 配合 tsify

安装

sh
npm install grunt-browserify tsify --save-dev

基本的 Gruntfile.js

js
module.exports = function (grunt) {
grunt.initConfig({
browserify: {
all: {
src: "src/main.ts",
dest: "dist/main.js",
options: {
plugin: ["tsify"],
},
},
},
});
grunt.loadNpmTasks("grunt-browserify");
grunt.registerTask("default", ["browserify"]);
};

更多详情:jmreidy/grunt-browserify、TypeStrong/tsify

Gulp

安装

sh
npm install gulp-typescript

基本的 gulpfile.js

js
var gulp = require("gulp");
var ts = require("gulp-typescript");
gulp.task("default", function () {
var tsResult = gulp.src("src/*.ts").pipe(
ts({
noImplicitAny: true,
out: "output.js",
})
);
return tsResult.js.pipe(gulp.dest("built/local"));
});

更多详情:ivogabe/gulp-typescript

Jspm

安装

sh
npm install -g jspm@beta

注意:目前 jspm 中的 TypeScript 支持还处于 0.16beta

更多详情:TypeScriptSamples/jspm

MSBuild

更新项目文件,在顶部包含本地安装的 Microsoft.TypeScript.Default.props,在底部包含 Microsoft.TypeScript.targets 文件:

xml
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Include default props at the top -->
<Import
Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.Default.props"
Condition="Exists('$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.Default.props')" />
<!-- TypeScript configurations go here -->
<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
<TypeScriptRemoveComments>false</TypeScriptRemoveComments>
<TypeScriptSourceMap>true</TypeScriptSourceMap>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
<TypeScriptRemoveComments>true</TypeScriptRemoveComments>
<TypeScriptSourceMap>false</TypeScriptSourceMap>
</PropertyGroup>
<!-- Include default targets at the bottom -->
<Import
Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets"
Condition="Exists('$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\TypeScript\Microsoft.TypeScript.targets')" />
</Project>

有关定义 MSBuild 编译器选项的更多详情:在 MSBuild 项目中设置编译器选项

NuGet

  • 右键 -> 管理 NuGet 包
  • 搜索 Microsoft.TypeScript.MSBuild
  • 点击 Install
  • 安装完成后,重新生成!

更多详情请参阅包管理器对话框和将每日构建与 NuGet 一起使用

Rollup

安装

npm install @rollup/plugin-typescript --save-dev

注意,typescript 和 tslib 都是该插件的对等依赖项,需要单独安装。

用法

创建一个 rollup.config.js配置文件并导入该插件:

js
// rollup.config.js
import typescript from '@rollup/plugin-typescript';
export default {
input: 'src/index.ts',
output: {
dir: 'output',
format: 'cjs'
},
plugins: [typescript()]
};

Svelte 编译器

安装

npm install --save-dev svelte-preprocess

注意,typescript 是该插件的可选对等依赖项,需要单独安装。它也不提供 tslib。

你也可以考虑使用 svelte-check 进行 CLI 类型检查。

用法

创建一个 svelte.config.js 配置文件并导入该插件:

js
// svelte.config.js
import preprocess from 'svelte-preprocess';
const config = {
// Consult https://github.com/sveltejs/svelte-preprocess
// for more information about preprocessors
preprocess: preprocess()
};
export default config;

现在你可以指定脚本块使用 TypeScript 编写:

<script lang="ts">

Vite

Vite 开箱即支持导入 .ts 文件。它只进行转译,不做类型检查。它还要求某些 compilerOptions 具有特定的值。更多详情请参阅 Vite 文档。

Webpack

安装

sh
npm install ts-loader --save-dev

使用 Webpack 5 或 4 时的基本 webpack.config.js

js
const path = require('path');
module.exports = {
entry: './src/index.ts',
module: {
rules: [
{
test: /\.tsx?$/,
use: 'ts-loader',
exclude: /node_modules/,
},
],
},
resolve: {
extensions: ['.tsx', '.ts', '.js'],
},
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist'),
},
};

请参阅此处的 ts-loader 更多详情。

替代方案:

TypeScript 文档是一个开源项目。欢迎发送 Pull Request 帮助我们改进这些页面 ❤

最后更新:2026 年 10 月 23 日