如何在VS Code中接入ts-rust:Rust TypeScript编译器的编辑器配置完全教程
如何在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,而tsc7 需要 9.57s、tsc6 需要 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,大型项目的类型检查与编辑体验都会明显提速——而诊断结果与官方编译器保持一致,可以放心替换使用。