开始使用

安装 evlog

在 TypeScript 项目中安装 evlog。支持 Nuxt、Next.js、SvelteKit、Hono、Express、Fastify、Elysia、NestJS 以及独立脚本。

evlog 支持 Nuxt、Next.js、SvelteKit、Nitro、NestJS 以及任何 TypeScript 服务端框架。

安装

pnpm add evlog

npm install evlog

yarn add evlog

bun add evlog

如果你使用了 AI 助手（如 Claude Code、Cursor 等），安装 evlog 技能以获得引导式设置和代码审查：

Terminal

npx skills add https://www.evlog.dev

你的 AI 助手随后可以帮助你设置 evlog、审查你的日志模式，并将现有代码迁移到宽事件。详情参见 Agent Skills。

安装包后，按照对应框架的设置指南进行操作：

Nuxt

带有自动导入的 useLogger、createError 和 parseError 的模块。

Next.js

createEvlog() 工厂函数与 withEvlog() 处理程序包装器。

SvelteKit

handle 与 handleError 钩子，使用 event.locals.log。

Nitro

适用于 Nitro v2 和 v3 的插件式钩子模块。

TanStack Start

使用 Nitro v3 模块与异步上下文。

React Router

使用 context.get(loggerContext) 的中间件。

NestJS

使用全局中间件的 EvlogModule.forRoot()。

Express

使用 req.log 的中间件。

Hono

使用 c.get('log') 的中间件。

Fastify

使用 request.log 的插件。

Elysia

使用 log 作为路由上下文的插件。

Cloudflare Workers

用于请求作用域日志记录器的工厂函数。

请参见完整的框架集成页面，以获取对比表格和所有可用集成，包括独立 TypeScript、Astro 和自定义集成。

evlog 附带完整的 TypeScript 类型定义，无需额外配置。

evlog 需要 TypeScript 5.0 或更高版本以获得最佳的类型推断。

介绍

一个用于 TypeScript 的结构化日志库。简单日志、广泛事件和结构化错误，从快速的一行代码到全面的请求范围事件。

快速开始

几分钟内上手 evlog。学习日志 API、为广泛事件创建 createLogger、处理请求的 useLogger，以及结构化错误。