Esbuild Runner：超快速现代JS/TS/JSX实时转译工具完全指南

Esbuild Runner：超快速现代JS/TS/JSX实时转译工具完全指南

【免费下载链接】esbuild-runner⚡️ Super-fast on-the-fly transpilation of modern JS, TypeScript and JSX using esbuild项目地址: https://gitcode.com/gh_mirrors/es/esbuild-runner

Esbuild Runner（简称esr）是一款基于esbuild的超快速现代JS、TypeScript和JSX实时转译工具，它能帮助开发者在无需完整构建项目的情况下，轻松运行任意代码或测试，显著提升开发工作流效率。

🌟 为什么选择Esbuild Runner？

在现代前端开发中，TypeScript、JSX等语法已成为标配，但传统的转译工具往往速度慢、配置复杂。Esbuild Runner凭借esbuild的极速性能，为开发者带来了革命性的开发体验：

• ⚡️ 闪电般的速度：基于esbuild引擎，转译速度比传统工具快10-100倍
• 🛠️ 零配置启动：无需复杂配置，开箱即用
• 🔄 实时转译：无需手动构建，修改代码后立即生效
• 📦 多场景支持：支持直接运行文件、Node.js注册、Jest测试和VSCode调试

🚀 快速开始

一键安装步骤

最简单的使用方式是全局安装Esbuild Runner并使用esr命令：

npm install -g esbuild-runner

如果希望仅在项目中使用，可以本地安装：

npm add --dev esbuild-runner

基本使用方法

安装完成后，您可以直接运行TypeScript文件：

esr your-file.ts

或者通过Node.js注册方式使用：

node -r esbuild-runner/register your-file.ts

⚙️ 核心功能与配置

两种转译模式

Esbuild Runner提供两种不同的代码转译方式，满足不同场景需求：

• 打包模式（默认）：一次性转译脚本及其所有依赖，node_modules中的依赖不会被转译，无缓存
• 转换模式（--cache）：对每个源文件单独调用esbuild，但会缓存结果，首次运行较慢，后续仅转译变更文件

# 使用缓存模式运行 esr --cache your-file.ts # 清除转换缓存 esr --clearCache

自定义配置

创建esbuild-runner.config.js文件来自定义esbuild选项：

// esbuild-runner.config.js module.exports = { type: "bundle", // 可选: "bundle" 或 "transform" esbuild: { // 任何esbuild构建或转换选项 target: "esnext", }, }

🔌 集成场景

Jest测试集成

在jest.config.js中配置Jest转换器：

module.exports = { transform: { "\\.ts$": "esbuild-runner/jest", }, }

VSCode调试配置

在.vscode/launch.json中添加调试配置：

{ "version": "0.2.0", "configurations": [ { "name": "Debug with esbuild-runner", "program": "${workspaceFolder}/your-file.ts", "runtimeArgs": [ "-r", "esbuild-runner/register" ], "request": "launch", "sourceMaps": true, "skipFiles": [ "<node_internals>/**" ], "type": "pwa-node" } ] }

📚 项目结构与源码

Esbuild Runner的核心源码位于src/目录，主要包含以下文件：

• src/cli.ts：命令行工具实现
• src/register.ts：Node.js注册模块
• src/jest.ts：Jest转换器实现
• src/esbuild.ts：esbuild核心调用逻辑
• src/cache.ts：缓存管理功能

🆕 最新特性

根据CHANGELOG.md，Esbuild Runner的最新版本带来了多项增强：

• ✨ 增加了自定义加载器支持
• ✨ 允许覆盖esbuild.external配置
• ✨ 支持通过配置文件传递构建/转换选项

📥 获取项目

要开始使用Esbuild Runner，可以克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/es/esbuild-runner

📄 许可证

Esbuild Runner采用Apache 2.0许可证，详情请查看项目根目录下的LICENSE文件。

通过使用Esbuild Runner，开发者可以告别漫长的构建等待，专注于代码编写和功能实现，让现代JavaScript开发变得更加高效和愉悦！

【免费下载链接】esbuild-runner⚡️ Super-fast on-the-fly transpilation of modern JS, TypeScript and JSX using esbuild项目地址: https://gitcode.com/gh_mirrors/es/esbuild-runner