0

0

VSCode如何配置TypeScript开发与编译【教程】

幻影之瞳

幻影之瞳

发布时间:2026-01-25 16:08:03

|

459人浏览过

|

来源于php中文网

原创

VSCode不编译TypeScript,需tsc完成;须安装tsc、配置tsconfig.json(含target/outDir/include)、设置tasks.json监听和launch.json的preLaunchTask及sourceMap。

vscode如何配置typescript开发与编译【教程】

VSCode 本身不编译 TypeScript,它只提供语法支持和智能提示;真正的编译必须由 tsc(TypeScript 编译器)完成,VSCode 只是调用它或监听其输出。

确认已安装 tsc 并在终端可用

很多人卡在这一步:以为装了 VSCode 就能编译 TS,结果右键“编译”没反应,或者 npm run buildtsc: command not found

  • 全局安装(推荐初学者):npm install -g typescript,然后在终端运行 tsc --version 确认输出版本号
  • 项目本地安装(更稳妥):npm install --save-dev typescript,之后用 npx tsc 调用(VSCode 任务默认会识别 npx
  • Windows 用户注意:PowerShell 或 CMD 中若提示命令不存在,先关掉 VSCode 再重开,确保 PATH 刷新

生成并理解 tsconfig.json 的关键配置项

没有 tsconfig.jsontsc 会降级为“仅检查语法”,不会生成 JS 文件——这也是常见“写了 .ts 却没产出 .js”的原因。

  • 最简有效配置只需两行:
    { "compilerOptions": { "target": "ES2020", "outDir": "./dist" }, "include": ["src/**/*"] }
  • "noEmit": true 是调试时的隐藏陷阱:它禁用所有输出,但类型检查照常,容易误以为编译失败
  • "rootDir""outDir" 必须成对出现且路径不重叠,否则 tsc 可能把 dist 里的 JS 当源码二次编译,导致循环错误
  • 开发中建议加 "sourceMap": true,否则断点调试会跳到编译后的 JS 行,而不是你写的 TS 行

用 VSCode 自动任务触发 tsc 监听模式

手动敲 tsc -w 太原始,VSCode 的 tasks.json 可以绑定快捷键(如 Ctrl+Shift+B),还能在问题面板直接定位报错。

《PHP程序设计》第二版
《PHP程序设计》第二版

本书图文并茂,详细讲解了使用LAMP(PHP)脚本语言开发动态Web程序的方法,如架设WAMP平台,安装与配置开源Moodle平台,PHP程序设计技术,开发用户注册与验证模块,架设LAMP平台。 本书适合计算机及其相关专业本、专科学生作为学习LAMP(PHP)程序设计或动态Web编程的教材使用,也适合对动态Web编程感兴趣的读者自觉使用,对LAMP(PHP)程序设计人员也具有一定的参考价值。

下载
  • Ctrl+Shift+P → 输入 “Tasks: Configure Task” → 选 “Create tasks.json from template” → “TypeScript – tsconfig.json”
  • 生成的 tasks.json 里确保 "isBackground": true"problemMatcher": "$tsc-watch" 存在,否则保存后不会自动重编译
  • 如果终端报 File change detected. Starting incremental compilation... 但没生成文件,大概率是 tsconfig.json"outDir" 路径写错,或 "include" 没覆盖到你的 .ts 文件

调试时别忽略 launch.jsonpreLaunchTask

直接 F5 启动 Node.js 调试却报“找不到 .js 文件”,往往是因为调试前没先编译——TS 文件还没变成可执行的 JS。

  • .vscode/launch.json 的配置中,必须指定:
    "preLaunchTask": "tsc: build - tsconfig.json"
    (任务名需与 tasks.jsonlabel 一致)
  • 若使用 nodemonts-node,那是绕过编译的运行方式,和本题的“配置编译”目标不同,不要混用
  • sourceMap 必须为 true,且 launch.json"outFiles" 要指向 dist/**/*.js,否则断点无效

真正麻烦的不是配置步骤,而是错误信息不指向真实原因:比如 tsc 静默不输出,大概率是 tsconfig.json 路径不对或被父目录的同名文件干扰;而调试断点失效,90% 出在 sourceMapoutFiles 的路径匹配上。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

417

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

76

2025.09.10

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

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

510

2023.06.20

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

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

244

2023.07.28

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

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

278

2023.08.03

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

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

5303

2023.08.17

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

51

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.6万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 7.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号