VSCode配置TypeScript自动编译为JS

P粉328763957

P粉328763957

2026-07-25

637人浏览

原创

vscode 默认不生成 .js 文件,需确保本地 tsc ≥5.0、正确配置 tsdk 路径、tsconfig.json 含 outdir/rootdir、通过 tasks.json 启用 tsc --watch 或用 nodemon+ts-node 实现热重载。

vscode配置typescript自动编译为js

VSCode 默认不生成 .js 文件,装了 TypeScript 插件也没用——你看到的“没报错”,只是编辑器在做类型检查,tsc 根本没跑。

确认 tsc 可用且版本 ≥ 5.0

VSCode 不自带可执行的 tsc,它只调用你本地装的编译器。终端里运行 npx tsc --version 必须输出类似 5.4.5 的数字,低于 5.0(比如 4.9.5)会导致 moduleResolution: "bundler"satisfies 等新特性被忽略。

推荐项目级安装:npm install --save-dev typescript。全局安装容易和多项目冲突,而且 VSCode 默认不优先用全局 tsc

装完后,必须在 VSCode 工作区设置里加这一行:"typescript.tsdk": "./node_modules/typescript/lib",否则编辑器可能继续用内置旧版语言服务,和实际编译行为不一致。

改完设置后,务必手动重启 TS 服务:Ctrl+Shift+P → 输入 TypeScript: Restart TS server → 回车。

tsconfig.json 必须有 outDirrootDir

空的 {} 或只有注释的 tsconfig.json 是无效的。tsc 会降级为单文件编译,outDirinclude 全部失效,.js 压根不会生成。

最小可行配置(放在项目根目录):

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "sourceMap": true,
    "inlineSourceMap": false,
    "strict": true
  },
  "include": ["src/**/*"]
}

outDirrootDir 必须配对:源码在 src/,就得写 "rootDir": "./src";否则 tsc 可能误扫 node_modules 或报 TS18003: No inputs were found

include 比默认注释掉的 files 更可靠,尤其有子目录时;不写 include 又没 files,tsc 就找不到任何输入。

删掉所有以 // 开头的行——JSON 不支持注释,tsc 解析失败直接退出。

php版微信js-sdk支付接口类
php版微信js-sdk支付接口类

php版微信js-sdk支付接口类

下载

tasks.json 启动 tsc --watch 后台任务

tsc --watch 是唯一能实现“保存即编译”的机制,但它不是 VSCode 自带功能,必须通过 .vscode/tasks.json 显式声明,并设 "isBackground": true,否则任务一结束就停,后续修改不会触发编译。

典型配置(.vscode/tasks.json):

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "tsc: watch",
      "type": "shell",
      "command": "npx tsc",
      "args": ["--watch"],
      "group": "build",
      "isBackground": true,
      "problemMatcher": ["$tsc-watch"]
    }
  ]
}

problemMatcher 必须是 ["$tsc-watch"],否则错误提示不显示在 Problems 面板;isBackground 必须为 true,否则 --watch 不会持续运行。

首次启用要手动触发:Ctrl+Shift+B → 选 tsc: watch。终端应显示 Found 0 errors. Watching for file changes. —— 这才真正开始监听。

别指望保存自动触发任务:VSCode 不默认绑定保存事件到构建任务,得靠这个后台进程自己监听文件系统变化。

想改完就执行?nodemon + ts-node 更顺

tsc --watch 只编译,不执行;ts-node 能直接跑 .ts,但默认不监听变化。

合体方案才是开发流舒适区:

  • 安装:npm install --save-dev ts-node nodemon
  • 加脚本到 package.json"dev": "nodemon --exec ts-node src/index.ts"
  • 运行:npx run dev

效果:改保存 → ts-node 实时转译 → nodemon 自动重启进程。调试时不用切到 dist/ 目录,也不用等 tsc 输出再手动 node

注意:ts-node 不读 tsconfig.jsonoutDir,它只做内存内转译;所以它和 tsc --watch 是两套逻辑,别混用同一份配置去强求一致。

最常被忽略的是:改了 tsconfig.json 或装了新依赖后,tsc --watch 进程不会自动 reload,得手动终止再 Ctrl+Shift+B 重开一次。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

125

17

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

2026.02.25

355

17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

2026.03.13

208

19

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

2026.06.03

97

29

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

88

8

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

1856

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

890

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1154

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

7909

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程