能直接运行.tsx文件，必须同时满足：正确安装node.js并配置path、项目级安装ts-node和typescript、终端位于项目根目录；否则会报“ts-node not recognized”或“cannot find module 'typescript'”错误。
能直接运行 .tsx 文件，但必须同时满足三个条件：装对 Node、装对 ts-node、且终端路径在项目根目录下——缺一不可，否则报错 'ts-node' is not recognized as an internal or external command 或 Cannot find module 'typescript'。
确认 Node.js 和 npm 已正确安装并可用
VSCode 本身不自带 Node 环境，它只是调用你系统里已安装的 node 和 npm。如果终端里执行 node -v 或 npm -v 报“不是内部或外部命令”，说明 Node 没进系统 PATH，VSCode 的集成终端也找不到它。
- Windows 用户：安装 Node.js 时勾选
Add to PATH；若已安装但没生效，重启 VSCode（不是仅关闭终端） - macOS / Linux：检查
which node输出路径是否在$PATH中，必要时在~/.zshrc或~/.bash_profile里追加export PATH="/usr/local/bin:$PATH" - 在 VSCode 终端里运行
node -v和npm -v，必须有输出版本号，才算真正就绪
项目级安装 ts-node 和 typescript（不推荐全局）
全局安装 ts-node（npm install -g ts-node）看似省事，但容易和项目中不同版本的 TypeScript 冲突，尤其当你用 import React from 'react' 这类 JSX 语法时，ts-node 会依赖项目本地的 typescript 配置来解析 .tsx。所以务必走项目级安装：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在项目根目录打开 VSCode 集成终端，运行：
npm init -y（生成package.json） - 再运行：
npm install -D typescript ts-node @types/node - 验证：
npx ts-node --version应输出版本号；npx ts-node script.tsx应能直接执行（无需先编译） - 注意：
@types/node不可省略，否则console.log、process.argv等会报类型错误
让 ts-node 正确识别 .tsx 并启用 JSX 支持
默认 ts-node 把 .tsx 当作普通 .ts 处理，遇到 React.createElement 或 <div></div> 就会报错 JSX element type does not have any construct or call signatures。必须显式告诉它启用 JSX：
- 项目根目录下创建
tsconfig.json（如果还没有）：tsc --init - 在
compilerOptions中确保包含这两项："jsx": "preserve"（或"react"）、"moduleResolution": "node" - 运行
npx ts-node -O '{"jsx":"preserve"}' src/app.tsx可临时覆盖配置；但长期建议写进tsconfig.json - 若用
import * as React from 'react'，还需在tsconfig.json的compilerOptions.types中加入["node", "react"]
VSCode 终端里直接运行 .tsx 的实操要点
很多人输完 npx ts-node xxx.tsx 仍失败，问题往往出在路径或权限上：
- 终端当前工作目录必须是项目根目录（即含
node_modules和tsconfig.json的目录），不能是src/子目录 - Windows 上若提示
ExecutionPolicy错误，不是 VSCode 问题，而是 PowerShell 策略限制；改用 CMD 或 Git Bash，或在管理员 PowerShell 中运行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 别用 VSCode 的“运行代码”插件（如 Code Runner）直接跑
.tsx—— 它默认调用node，不是ts-node；想用它，得在settings.json里自定义 executor："code-runner.executorMap": {"typescript": "npx ts-node"} - 调试时，
launch.json中type: "node"的配置默认不支持.tsx；要改成"runtimeExecutable": "npx", "runtimeArgs": ["ts-node"], "args": ["${file}"]
最简验证方式：新建 hello.tsx，写 console.log('OK');，在项目根目录终端执行 npx ts-node hello.tsx —— 成功即代表环境闭环。真正的复杂点不在安装步骤，而在于 tsconfig.json 与 ts-node 启动参数的耦合关系，稍有 mismatch 就静默失败。
