# @adguard/logger 中文文档

规范地址：https://npmcn.com/package/%40adguard/logger/

版本：2\.0\.1
npm 元数据更新时间：2026-08-28T20:12:03.371Z
中文译文更新时间：2026-11-06T03:35:19.846Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adguard/logger
原文对照：https://npmcn.com/package/%40adguard/logger/?lang=original
项目主页：https://github.com/AdguardTeam/tsurlfilter/tree/master/packages/logger#readme
源码仓库：https://github.com/AdGuardSoftwareLimited/ext-tsurlfilter

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：41.2 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2024-04-03T16:04:33.107Z
- 最新版本发布：2026-08-28T20:12:03.189Z
- 近 30 天下载量：5486（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 1 个）

## 中文简介

AdGuard Logger是一个简单的工具,用于从AdGuard扩展记录.

## 安装

```sh
npm install @adguard/logger
```

也可以使用：`pnpm add @adguard/logger`、`yarn add @adguard/logger`、`bun add @adguard/logger`

## README

# 守护 Logger

AdGuard Logger是一个简单的工具,用于从AdGuard扩展记录.

## 使用量

### 安装

```bash
pnpm add @adguard/logger
```

### 基本用途

该软件包支持CommonJS和ES模块导入样式.

```javascript
const { Logger } = require('@adguard/logger');
// or
import { Logger } from '@adguard/logger';

const logger = new Logger();
logger.info('This is an info message');
```

默认日志级别设定为 `info`,意思是信息在 `debug` 关卡不会被记录. 您可以通过设置日志级别来调整 :

```typescript
import { Logger, LogLevel } from './Logger';

const logger = new Logger();
logger.currentLevel = LogLevel.Debug;
console.log(logger.currentLevel); // Outputs 'debug'
logger.debug('This is a debug message');
```

此外,您可以通过提供自己的日志撰写器来定制您的日志解决方案, 而不是仅仅依赖默认 `console` 日志编辑器 :

```typescript
import { Logger, LogLevel } from './Logger';

const writeToFile = (...args: any[]) => {
// Implement file writing logic here
};
const writer = {
    log: (...args: any[]): void => {
        writeToFile(...args);
        console.log(...args);
    },
    error: (...args: any[]): void => {
        writeToFile(...args);
        console.error(...args);
    },
    info: (...args: any[]): void => {
        writeToFile(...args);
        console.info(...args);
    },
};
const logger = new Logger(writer);
```

#### Verbose 记录和跟踪输出

这种模式的设计完全是为了开发和调试目的, 在控制台中提供可点击的调用堆栈跟踪 对于代码执行的最大限度的洞察.

当日志设定为 `LogLevel.Verbose`,除此之外,所有日志方法 `error()` 将打印一个调用堆栈跟踪. 这有助于跟踪执行过程并诊断出复杂的问题. 堆栈跟踪显示为控制台中已倒塌的组 如果写入器支持 `groupCollapsed` 财务报告和审定财务报表 `groupEnd`, (中文(简体) ), 使日志更容易读取;否则会打印出痕迹.

为促成这种行为,必须满足下列条件:

-   日志级别必须设置为 `LogLevel.Verbose`。 。 。 .
-   日志方法不能是 `error()` (自2006年起) `error()` 已包含堆栈跟踪).

该功能针对需要详细,分步跟踪应用程序执行的开发者.

## 文档

-   [更改日志](https://npmcn.com/package/%40adguard/logger/CHANGELOG.md)
-   [发展指南](https://npmcn.com/package/DEVELOPMENT.md)
-   [LLM 代理规则](https://npmcn.com/package/%40adguard/logger/AGENTS.md)

## 常见问题

### @adguard/logger 是什么？

AdGuard Logger是一个简单的工具,用于从AdGuard扩展记录\.

### 如何安装 @adguard/logger？

在项目目录运行 npm install @adguard/logger，或使用 pnpm add / yarn add / bun add。

### @adguard/logger 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adguard/logger 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @adguard/logger 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adguard/logger 可以商用吗？

@adguard/logger 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adguard/logger 的下载量有多少？

根据 npm 官方下载统计，@adguard/logger 在 2026/10/05 – 2026/11/03 这 30 天内被下载 5,486 次，日均约 183 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adguard/logger 还在维护吗？

最新版本 2\.0\.1 发布于 2026/08/29（2 个月前）；至今共发布 7 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/04/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。