vscode本身不运行typescript，真正执行依赖node.js与tsc或ts-node；关键在于正确调用本地工具链并解决模块格式、路径解析、sourcemap匹配及ts服务缓存等问题。
VSCode 本身不运行 TypeScript，它只提供编辑、提示和类型检查能力；真正让 .ts 文件“跑起来”的，是 Node.js + TypeScript 编译器（tsc）或执行器（ts-node）。配置的关键不是“让 VSCode 支持 TS”，而是让它正确调用本地工具链，并避免常见路径、版本和监听冲突问题。
为什么 tsc 编译后 Node.js 还报错“Cannot use import statement outside a module”
这是最常见的运行失败现象，本质是编译输出的 JavaScript 不符合 Node.js 当前模块系统要求。
-
"module": "commonjs"是 Node.js 默认兼容的模块格式，但如果你在tsconfig.json中设成了"module": "ESNext"或"module": "es2020"，tsc会输出import/export语法，而未启用--experimental-modules的 Node.js 会直接拒绝执行 - 即使
module设对了，若"type": "module"出现在package.json中，Node.js 会强制以 ESM 模式加载所有.js文件——此时tsc输出的commonjs代码也会被当作 ESM 解析，导致require is not defined - 解决方案：统一模块策略。推荐保持
"module": "commonjs"，并确保package.json中**没有**"type": "module"；如需 ESM，改用ts-node --esm启动，而非tsc+node
用 ts-node 直接运行 .ts 文件时提示 “Cannot find module 'ts-node/register'”
这个错误说明 ts-node 没有被正确安装或未被 Node.js 找到，不是 VSCode 的问题，而是执行上下文缺失。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
-
ts-node必须作为项目依赖安装：npm install --save-dev ts-node（不能只全局装，VSCode 调试或终端运行时默认使用本地node_modules/.bin下的二进制） - 如果通过
npx ts-node src/index.ts运行正常，但在 VSCode 的launch.json中配置"runtimeArgs": ["-r", "ts-node/register"]失败，大概率是ts-node/register路径解析失败——应改用"runtimeArgs": ["-r", "ts-node/transpile-only"]（更稳定）或直接指定完整路径："-r", "./node_modules/ts-node/dist/index.js" - 注意 Node.js 版本兼容性：
ts-nodev10+ 要求 Node.js ≥ 16.14；若用的是 Node.js 14 或更旧版本，需降级ts-node到 v9.x
VSCode 调试时断点不命中，或显示 “No source available”
这几乎总是 sourceMap 配置或生成路径不匹配导致的，和 TypeScript 版本无关，但和 outDir/rootDir 组合强相关。
- 必须在
tsconfig.json中启用："sourceMap": true，且确保"outDir"和"rootDir"明确指定（例如"outDir": "./dist","rootDir": "./src"），否则tsc可能无法正确生成映射关系 - 如果用
tsc --watch编译，但调试时打开的是src/index.ts，而launch.json的"program"指向dist/index.js，VSCode 会尝试从dist/index.js.map反查源码路径；此时若map文件里写的是../src/index.ts，但实际项目结构是./src/，就会找不到源文件 - 简单验证法：编译后打开生成的
.js.map文件，检查"sources"字段是否为相对路径且可被 VSCode 正确解析；如有疑问，加一项"inlineSources": true，把源码直接嵌入 map 文件，绕过路径查找
修改 tsconfig.json 后 VSCode 类型提示没更新
VSCode 的 TS 服务有时会缓存旧配置，尤其在切换 target、lib 或增删 types 时，不会自动重载。
- 手动触发重载：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入 “TypeScript: Restart TS server”，回车执行 - 确认 VSCode 使用的是项目本地 TypeScript 版本：点击右下角 TypeScript 版本号（如 “TypeScript 5.4”），选择 “Use Workspace Version”；若显示 “Use VS Code’s Version”，说明它在用内置 TS，可能与你
package.json里声明的版本不一致 - 某些配置项（如
"skipLibCheck": true）只在tsc编译时生效，不影响编辑器实时检查——这类项改完后必须重启 TS Server 才能看到效果
最常被忽略的一点：VSCode 的 TypeScript 支持依赖于项目根目录下存在有效的 tsconfig.json。如果只是在子文件夹里放了个 .ts 文件，而没有 tsconfig.json，VSCode 会退回到基础 JavaScript 模式，连基本的类型推导都会失效——哪怕你全局装了 TypeScript，也救不了这个空配置。
