如何在VS Code中接入ts-rust:Rust TypeScript编译器的编辑器配置完全教程

原创2026-11-03 13:20:351,755 阅读

如何在VS Code中接入ts-rust:Rust TypeScript编译器的编辑器配置完全教程

ts-rust(又名 tsc-rs)是一个用 Rust 编写的 TypeScript 7 编译器(tsc)移植版:它保留了与 Go 版完全相同的命令行、语言服务器和 API,同时类型检查速度约为 TypeScript 7 的 3 倍、TypeScript 6 的 15 倍以上。本文带你完成 VS Code 编辑器配置:从一键安装、npm 别名接入到 --fast 极速模式,让你的 IDE 直接用上这个 Rust TypeScript 编译器。

本文包含:

  • ts-rust 是什么,性能对比一目了然
  • VS Code 接入的 3 个配置步骤(含 package.json 配置)
  • --fast 极速模式与语言服务器加速
  • 源码结构速览与常见问题排查

一、ts-rust 是什么:一个"快人一步"的 Rust TypeScript 编译器

ts-rust 是对微软原生 TypeScript 编译器(Go 编写的 TypeScript 7,即 tsc)的逐行 Rust 移植,上游版本固定并持续对齐(见 UPSTREAM.md)。它带来的直接好处:

  • 更快:官方实测(16 核机器)中,VS Code 代码库全量类型检查 tsc-rs --fast 仅需 2.64s,而 tsc 7 需要 9.57s、tsc 6 需要 91.75s
  • 一致:诊断输出与 Go 版逐字节一致,186,890 个测试全部通过,可视为即插即用的 tsc 替代品
  • 内置 Effect 诊断:Effect 项目无需第二个编译器,语言服务器直接展示 Effect 规则(377xxx 系列诊断)、快速修复与重构
  • 全平台:支持 Linux x64/arm64、macOS arm64/x64、Windows x64/arm64(README.md)

💡 对普通用户来说,最大的感受就是:打开 VS Code 等报错的时间,几乎"秒出"。

二、安装准备:两条命令认识 tsc-rs

ts-rust 通过 npm 分发,核心就两个包,用途不同:

npm 包名 用途
tsc-rs 命令行类型检查器,等价于 tsc
@tsc-rs/typescript 以 typescript 身份安装,供 VS Code 的 TypeScript 7 扩展使用

先安装命令行版本试水:

npm install -D tsc-rs
npx tsc-rs -p tsconfig.json

tsc-rs 接受与 tsc 完全相同的选项(README.md)。如果你的项目有 Effect 插件配置,诊断结果里会同时出现 Effect 规则报告。

三、VS Code 接入配置:3 步让编辑器用上 Rust 编译器

这是本文的核心。VS Code 的 TypeScript 7 扩展会优先使用工作区本地的 typescript 包(其中的 tsc 可执行文件即语言服务器入口)。所以接入的关键,是把 @tsc-rs/typescript 以 typescript 的别名装进项目(0.7.0 之后的版本支持,README.md)。

第 1 步:修改 package.json

在项目的 devDependencies 中加入 npm 别名映射:

{
  "devDependencies": {
    "typescript": "npm:@tsc-rs/typescript@<version>"
  }
}

第 2 步:重新安装依赖并重载窗口

npm install

然后在 VS Code 中执行 Ctrl+Shift+P → Developer: Reload Window,让扩展重新探测本地编译器。

第 3 步:验证语言服务器已切换

npx tsc --version

⚠️ 这里会显示 7.1.0-beta——这是它移植的 TypeScript 版本,而不是 npm 包版本号,属于预期行为(README.md)。确认无误后,你的编辑器补全、悬停、跳转、诊断就全部由 Rust 编译器驱动了。

终端命令行检查(可选但推荐)

如果只想在终端用它做 CI 或手动检查,保持第一节的方式即可:

npx tsc-rs -p tsconfig.json --noEmit

四、开启 --fast 极速模式:大项目再提速 2.9 倍

默认模式下 tsc-rs 已比 tsc 7 快约 2.1 倍;开启 --fast 后可再上一个台阶:它按核心数启动最多 16 个检查器,并启用惰性成员表等优化(实现见 fast_mode.rs)。

1. 命令行加参数

npx tsc-rs --fast -p tsconfig.json

2. 语言服务器加速(编辑器内生效)

设置环境变量 GOPORT_FAST=1,LSP 和 API 服务器都会进入快速模式:

# macOS / Linux
export GOPORT_FAST=1
# Windows PowerShell
$env:GOPORT_FAST = "1"

3. 精细控制(进阶)

选项 效果
--checkers 8 指定检查器数量,8 核机器上 VS Code 检查快约 30%
GOPORT_FAST_STEAL=1 开启工作窃取,超大项目更激进

实测参考(16 核机器,README.md):

应用 tsc 7 tsc-rs tsc-rs --fast
VS Code 9.57s 4.81s 2.64s
Sentry (前端) 13.49s 5.30s 2.97s
TypeORM 0.70s 0.39s 0.27s

💡 小项目上 --fast 收益有限;它的 CPU 时间最多增加 2.2 倍、峰值内存最多 1.9 倍,但所有基准测试的诊断结果保持一致。

五、源码结构速览:读懂这个 Rust TypeScript 编译器

如果你想深入这个项目的实现,以下是关键模块路径:

  • 命令行与 LSP 入口:src/cmd/tsgo/lsp.rs——--lsp --stdio 启动流程、父进程看门狗(编辑器崩溃时自动清理语言服务器)
  • 语言服务器实现:src/lsp/——LSP 协议、进度上报、文件监听
  • 语言服务层:src/ls/——补全、重命名、引用查找、代码操作等编辑器功能
  • Effect 诊断规则:src/effect/rules/——100+ 条 Effect 专属检查规则
  • 内置类型库:crates/ts_goport/libs/——lib.*.d.ts 系列
  • 移植契约与背景:PORTING.md、NOTICE.md

如果想从源码构建,先获取代码:

git clone https://gitcode.com/gh_mirrors/ts/ts-rust

构建方式详见 README.md 的 Development 章节。

六、常见问题与排查

Q1:编辑器里报错闪烁或诊断不对? 先确认本地 typescript 包确实是别名版本:npx tsc --version 应输出 7.1.0-beta。若输出 5.x / 6.x,说明扩展仍在使用系统或旧版包,重新 npm install 后重载窗口。

Q2:为什么 --version 不是 npm 版本号? tsc-rs --version 打印的是它移植的 TypeScript 版本(7.1.0-beta),因为编译器需要用它匹配 typesVersions(README.md)。

Q3:长时间编辑后内存会不会一直涨? 会有缓慢增长(每 1000 次编辑约 3.1–4.6 MiB),但绝对值仍低于 tsc(10,000 次编辑后约 232 MiB 对比 291 MiB),属于已知问题(README.md)。

Q4:monorepo 里出现 TS6059(文件不在 rootDir 下)? 部分 monorepo 中工作区包源码既可通过 node_modules 又可通过直接导入到达,tsc-rs 会比 tsc 为更多文件写出产物。这是 tsc 本身行为不稳定的角落,tsc-rs 给出了每次运行一致的结果(README.md)。

Q5:我的平台支持吗? Linux x64/arm64(静态编译,任意发行版)、macOS arm64/x64、Windows x64/arm64 均有独立二进制(README.md)。

七、小结

接入 ts-rust 到 VS Code 的本质只有一句话:把 @tsc-rs/typescript 以 typescript 别名装进项目,TypeScript 7 扩展就会自动切换到你手边的 Rust TypeScript 编译器。再配合 --fast 或 GOPORT_FAST=1,大型项目的类型检查与编辑体验都会明显提速——而诊断结果与官方编译器保持一致,可以放心替换使用。

登录后查看全文
ts-rust