Skip to content
我们的赞助商
Open in Anthropic

与 Node.js 集成

Elysia 提供了运行时适配器,可在多个运行时环境中运行 Elysia,包括 Node.js。

要在 Node.js 上运行 Elysia,只需安装 Node 适配器。

bash
bun add elysia @elysiajs/node
bash
pnpm add elysia @elysiajs/node
bash
npm install elysia @elysiajs/node
bash
yarn add elysia @elysiajs/node

然后将 node 适配器应用到你的主 Elysia 实例中。

typescript
import { Elysia } from 'elysia'
import { node } from '@elysiajs/node'

const app = new Elysia({ adapter: node() }) 
	.get('/', () => 'Hello Elysia')
	.listen(3000)

这就是你运行 Elysia 于 Node.js 所需的一切。

额外设置(可选)

为了获得最佳体验,我们建议安装 tsxts-node 以及 nodemon

tsx 是一个 CLI 工具,它能将 TypeScript 转译为 JavaScript,支持热重载以及你期望现代开发环境具备的诸多功能。

bash
bun add -d tsx @types/node typescript
bash
pnpm add -D tsx @types/node typescript
bash
npm install --save-dev tsx @types/node typescript
bash
yarn add -D tsx @types/node typescript

然后打开你的 package.json 文件并添加以下脚本:

json
{
   	"scripts": {
  		"dev": "tsx watch src/index.ts",
    	"build": "tsc src/index.ts --outDir dist",
  		"start": "NODE_ENV=production node dist/index.js"
   	}
}

这些脚本指代开发应用的不同阶段:

  • dev - 在开发模式下启动 Elysia,并在代码更改时自动重载。
  • build - 构建应用以供生产使用。
  • start - 启动 Elysia 生产服务器。

确保创建 tsconfig.json 文件:

bash
tsc --init

别忘了将 tsconfig.json 中的 compilerOptions.strict 设置为 true

json
{
   	"compilerOptions": {
  		"strict": true
   	}
}

这将为你提供热重载和 JSX 支持,使你以类似于 bun dev 的体验运行 Elysia。