tsrs Node API完全参考：同步与异步API构建你自己的TypeScript工具链-北京尧图网络

【免费下载链接】tsrsRust port of the TypeScript 7 type checker项目地址https://gitcode.com/gh_mirrors/ts/tsrs点击查看免费下载tsrs 是 Rust 编写的 TypeScript 7 类型检查器其 npm 包tsrs同时提供完整的Node APItsrs/sync同步 API 与tsrs/async异步 API。两者可直接嵌入你的 Node.js 脚本、CLI 工具或 CI 流水线完成类型诊断、AST 遍历、模块解析、转译与构建编排助你快速构建自己的 TypeScript 工具链。快速安装一条命令接入 tsrs Node APItsrs 的 JS API 通过 npm 分发安装后即可在 Node.js≥16.20中使用pnpm add -D tsrs安装完成后根导出会给出版本信息const { version, typescriptVersion, typescriptCommit } require(tsrs); 主包会自动解析平台原生包tsrs/os-arch无需手动下载二进制详见 npm/README.md。tsrs Node API 导出子路径一览tsrs包按 TypeScript 7 官方包的子路径结构组织导出见 npm/tsrs/package.json子路径内容tsrs/sync同步调用APIMessagePack 走服务端 stdiotsrs/async返回 Promise 的异步APIJSON-RPCtsrs/ast含/is、/factory、/utils、/scanner、/visitor、/cloneAST 类型、守卫函数、工厂与遍历tsrs/fs、tsrs/proto文件系统回调 / 请求文件系统、协议类型tsrs/path强类型路径构造器与工具tsrs/vscodecreateTypeScriptModuleLoader与编辑器 SDK 类型所有子路径均附带类型声明配合tsconfig.schema.json/jsconfig.schema.json可直接做类型化开发。同步 API三行代码拿到类型诊断同步 API 适合脚本和一次性任务。构造API时它会拉起tsrs --api服务进程import { API } from tsrs/sync; const api new API({ cwd: process.cwd() }); // tsserverPath 可覆盖默认二进制 const snapshot api.createSnapshot({ openProjects: [/abs/path/tsconfig.json] }); const project snapshot.getConfiguredProject(/abs/path/tsconfig.json); console.log(project.program.getSemanticDiagnostics(/abs/path/src/index.ts)); project.program.emit(); // 按项目的编译器选项输出 api.close();核心对象链路是createSnapshot→Project→Programapi.createSnapshot(params)建立一次项目集合快照params支持openProjects、userPreferences等snapshot.updateSnapshot(...)可在文件变更后增量更新project.program上可调用getSemanticDiagnostics、getSyntacticDiagnostics、emit、emitToString等方法。异步 API基于 Promise 与资源自动释放异步 API 与同步版一一对应但每个调用返回 Promise适合长驻服务import { API as AsyncAPI } from tsrs/async; const api new AsyncAPI({ cwd: process.cwd() }); const snapshot await api.createSnapshot({ openProjects: [/abs/path/tsconfig.json] }); const diagnostics await snapshot .getConfiguredProject(/abs/path/tsconfig.json)! .program.getSemanticDiagnostics(/abs/path/src/index.ts); await api.close();资源管理细节值得注意异步Snapshot、Program、BuildOrchestrator实现了Symbol.asyncDispose支持await using自动等待清理完成TypeScript 消费端需要esnext.disposable或更新 lib来支持Symbol.dispose/Symbol.asyncDispose声明在旧版 Node 上缺少 dispose 符号时请显式调用close()/dispose()。一个典型差异若服务进程意外退出异步 API 会让所有挂起及后续请求以API server connection lost: ...开头的错误快速失败而不是无限挂起见 npm/sdk/patches/ 中的补丁说明。实战技巧批量请求、计时与文件系统回调批量请求API.batch可把多个请求合并发送减少往返。注意同步 API 的 generator 实例是单次使用的跨batch复用会抛出Cannot execute the same generator instance more than once与上游 TypeScript 行为一致。计时快照设置collectTiming: true或环境变量TS_API_TIMING_DIR指向非空目录后客户端close()时会写出一份包含客户端与服务端计时数据的 JSON 快照。文件系统回调APIOptions支持fsFileSystemCallbacks与useCaseSensitiveFileNames让类型检查运行在你自定义的文件系统之上也可用tsrs/fs的createFileSystem构造纯内存的请求文件系统import { createFileSystem, type FileSystemCallbacks } from tsrs/fs; import { API, type APIOptions } from tsrs/sync; const requestFileSystem createFileSystem([[/a.ts, export {};]]); const options: APIOptions { cwd: /, tsserverPath: /path/to/tsrs, fs: callbacks };完整类型化示例可参考 npm/sdk/smoke/typed.mts。177 个方法覆盖矩阵与状态速查tsrs 的 API 协议与 TypeScript 7 原生 API 完全对齐共177 个方法58 个 core 119 个 checker 方法。官方文档 docs/NODE_API.md 末尾附有完整覆盖矩阵状态含义如下supported有核心 Rust 测试覆盖的真实编译器会话行为partial已实现并分派但仅由上游 Node 测试套件或组件级检查覆盖或存在已记录的差异not implemented如startCPUProfile、stopCPUProfile、saveHeapProfile三个性能剖析方法暂未实现。未实现的方法会返回显式api: unsupported: ...错误绝不假装成功。方法级请求统计见 npm/sdk/METHODS.md在上游 SDK 套件中968/968 测试在 tsrs 上全部通过177 个方法中 170 个有成功响应。常用方法分组速览类别代表方法诊断getSemanticDiagnostics、getSyntacticDiagnostics、getDeclarationDiagnostics输出emit、emitToString、transpileModule、getDeclarationEmit符号/类型getSymbolAtPosition、getTypeAtPosition、typeToString、getCompletionsAtPosition模块解析createModuleResolver、resolveModuleName构建createBuildOrchestrator、build、buildReferences、cleanBuild配置parseCommandLine、readConfigFile、parseConfigFile常见问题与注意事项❓与 TypeScript 5 的createProgram兼容吗不兼容。tsrs 不提供一次性 CLI 包装对象协议来自 TypeScript 7 原生 API 移植客户端与服务端必须来自同一提交无版本协商。❓自动补全需要自动导入时怎么办先调用updateSnapshot并传prepareAutoImports附带要索引的文件再以includeSymbol: true调用getCompletionsAtPosition未准备的快照会收到客户端错误。❓相对路径的编译选项如何解析快照程序和 transpile 请求支持原始编译选项其中相对选项路径基于 API 服务进程的当前目录解析initialize响应会报告caseSensitivity与currentDirectory。❓同步客户端崩溃后行为如何同步客户端不做补丁服务崩溃后下一次调用会立即抛出管道错误异步客户端则如前文所述以连接丢失错误快速失败。相关文件与延伸阅读官方使用文档docs/NODE_API.mdnpm 打包与 JS API 说明npm/README.mdSDK 方法清单与测试统计npm/sdk/METHODS.md同步客户端源码npm/tsrs/src/api/sync/api.ts异步客户端与连接丢失补丁npm/tsrs/src/api/async/client.ts客户端选项定义npm/tsrs/src/api/options.tsRust 服务端核心crates/tsrs_api/src/lib.rs、crates/tsrs_api_transport/src/lib.rs掌握tsrs/sync与tsrs/async这两套 API你就能在 CI 门禁、代码生成器、LSP 之外的工具场景里把 TypeScript 7 级别的类型能力无缝集成进自己的工具链赞分享【免费下载链接】tsrsRust port of the TypeScript 7 type checker项目地址https://gitcode.com/gh_mirrors/ts/tsrs点击查看免费下载相关推荐Hiring Agent配置指南Ollama与Gemma3模型本地部署最佳实践Hiring Agent配置指南Ollama与Gemma3模型本地部署最佳实践 Hiring Agent是一款强大的AI简历评估工具能够从PDF中提取结构化人工智能AI 应用本地部署MusE性能优化技巧如何配置实时优先级和内存设置以获得最佳性能MusE性能优化技巧如何配置实时优先级和内存设置以获得最佳性能 MusE是一款功能强大的数字音频工作站支持音频和MIDI录制与编辑。对于音乐制作人和音频工程音视频TypeScript 原生 API 新增 typescript-eslint 所需检查器 API同步与异步接口全面解析TypeScript 原生 API 新增 typescript eslint 所需检查器 API同步与异步接口全面解析导读 2026 年 9 月 14 日文档教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

tsrs Node API完全参考：同步与异步API构建你自己的TypeScript工具链

相关推荐

基于强化学习与DeepSeek的零售动态补货调优实战

一维CNN滚动轴承故障诊断：从振动信号到故障标签的工程实践

TensorFlow实现Weibull生存模型预测债券违约概率

更多资讯

如何将真实地点转换为 Minecraft 地图：Arnis 三步上手完整指南

QuickLook 32/64位版本安装路径冲突：从诊断到修复的完整指南

数据科学免费自学路线：一份排好顺序的完整 MOOC 课程清单

QuickLook 按空格没反应？快速定位预览安装与位数问题的排查步骤

剑网3智能宏项目 JX3Toy：职业宏脚本工具与上手指南

Qwopus-GLM-18B-Merged-GGUF多语言能力深度测试：支持中、英、日、韩等多语言的全能模型

今日更新

AI智能体开发实战：从技术原理到商业落地

OpenShell 完全定制指南：从安装到深度配置，打造高效 Windows 开始菜单

Superpowers技能体系全解析：从Skills引入到安装的完整指南

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？