---
title: "日志记录"
description: "Nuxt Kit 提供了一套实用工具，帮助您进行日志记录。这些函数允许您带有额外功能地记录消息。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/kit/logging"
---
# 日志记录

> Nuxt Kit 提供了一套实用工具，帮助您进行日志记录。这些函数允许您带有额外功能地记录消息。

Nuxt 提供了一个日志实例，您可以使用它来带有额外功能地记录消息。`useLogger` 允许您获取一个日志实例。

## `useLogger`

返回一个日志实例。它在底层使用了 [consola](https://github.com/unjs/consola)。

### 用法

```ts twoslash
import { defineNuxtModule, useLogger } from '@nuxt/kit'

export default defineNuxtModule({
  setup (options, nuxt) {
    const logger = useLogger('my-module')

    logger.info('Hello from my module!')
  },
})
```

### 类型

```ts
function useLogger (tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance
```

### 参数

**`tag`**: 一个用于在所有日志消息后缀的标签，显示在右侧靠近时间戳的位置。

**`options`**：Consola 配置选项。

### 示例

```ts twoslash
import { defineNuxtModule, useLogger } from '@nuxt/kit'

export default defineNuxtModule({
  setup (options, nuxt) {
    const logger = useLogger('my-module', { level: options.quiet ? 0 : 3 })

    logger.info('Hello from my module!')
  },
})
```

---

- [源码](https://github.com/nuxt/nuxt/blob/main/packages/kit/src/logger.ts)


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.