VSCode本身不运行TypeScript，仅提供类型检查、语法提示和调试支持；真正运行需通过tsc编译为JS后由Node.js执行，或借助ts-node等工具实现即时编译与调试。

VSCode 本身不“运行” TypeScript，它只做类型检查、语法提示和调试支持；真正运行 TS 代码必须先编译成 JS，再交给 Node.js 或浏览器执行。你看到的“直接运行 .ts 文件”，背后一定是某层工具（如 ts-node）在帮你做即时编译——而 VSCode 的调试器只是把这层链路串起来了。

为什么 tsc 编译后没生成 .js 文件？

因为 tsc 默认只做类型检查，不输出 JS。你得显式告诉它“要落地文件”：

• 在 tsconfig.json 中加 "outDir": "./dist" 和 "rootDir": "./src"，否则 tsc 不知道从哪读、往哪写
• "noEmit": true（或未设）会禁用输出，检查你的 compilerOptions 里有没有这一项
• include 路径写错也会导致“没文件可编译”，比如写成 "src/**"（缺 /*）或 "src\**\*"（反斜杠 Windows 风格，在 JSON 里无效）
• 终端执行 tsc --noEmit false 可强制开启输出，用来快速验证配置是否生效

怎么让 VSCode 调试器直接跑 .ts 文件？

靠的是 launch.json + ts-node 组合，不是 VSCode 原生能力：

Scrapfly SDK TypeScript

使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。

下载

• 先装 ts-node：运行 npm install --save-dev ts-node @types/node
• 在 .vscode/launch.json 里配一个 pwa-node 类型配置，"program" 指向 .ts 入口，比如 "${workspaceFolder}/src/index.ts"
• 关键要加 "runtimeArgs": ["-r", "ts-node/register"]，否则调试器根本不知道用 ts-node 加载
• 别依赖 preLaunchTask: "tsc: build"——那是为纯 tsc 编译准备的，和 ts-node 冲突

为什么 VSCode 底部显示 TS 版本但调试仍报错？

状态栏版本号只说明语言服务加载了，不代表调试器也用了同一套环境：

• 右下角点 TypeScript 版本 → 选 Use Workspace Version，确保编辑器提示和 tsc 行为一致
• 但调试器（node 进程）只认你 package.json 里装的 ts-node，和 workspace TS 版本无关
• 如果 ts-node 报 Cannot find module 'xxx'，大概率是 tsconfig.json 里漏了 "resolveJsonModule": true 或 "baseUrl"/"paths" 没配对
• 每次改完 tsconfig.json，按 Ctrl+Shift+P → 输入 TypeScript: Restart TS server，否则编辑器缓存旧规则

最易被忽略的一点：VSCode 的“运行”按钮（▶️）默认不触发任何编译或执行逻辑，它只响应 launch.json 配置；没配就点不动，配错了就报路径不存在——这不是 bug，是设计使然。