# @appsignal/nodejs 中文文档

规范地址：https://npmcn.com/package/%40appsignal/nodejs/

版本：3\.9\.4
npm 元数据更新时间：2026-10-23T10:01:40.634Z
中文译文更新时间：2026-11-06T12:29:08.399Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40appsignal/nodejs
原文对照：https://npmcn.com/package/%40appsignal/nodejs/?lang=original
项目主页：https://github.com/appsignal/appsignal-nodejs#readme
源码仓库：https://github.com/appsignal/appsignal-nodejs

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

- 包体积（解压后）：401 kB，88 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 20\.6\.0
- 运行依赖：30 个
- 首次发布：2020-01-23T15:42:37.077Z
- 最新版本发布：2026-10-23T10:01:40.198Z
- 近 30 天下载量：62755（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：154（近 12 个月 8 个）

## 中文简介

AppSignal for Node.js 图书馆.

## 安装

```sh
npm install @appsignal/nodejs
```

也可以使用：`pnpm add @appsignal/nodejs`、`yarn add @appsignal/nodejs`、`bun add @appsignal/nodejs`

## README

# 节点的 AppSignal.js

AppSignal for Node.js 图书馆.

-   [AppSignal.com网站 (中文(简体) )](https://www.appsignal.com/nodejs)
-   [文档](https://docs.appsignal.com/nodejs/)
-   [支助](mailto:support@appsignal.com)

![npm (scoped)](https://img.shields.io/npm/v/@appsignal/nodejs) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)

## 安装

请跟我们走 [安装指南](https://docs.appsignal.com/nodejs/3.x/installation) 我们的文件。 我们试图自动设置尽可能多的软件包,但可能并不总是能够。 一定要跟随任何 [添加手动仪器的指令](https://docs.appsignal.com/nodejs/3.x/integrations)。 。 。 .

## 发展

### 安装

此寄存器是一个 [单一管理仓库](https://github.com/appsignal/mono/)。首先在您的本地机器上安装单体 [单位安装步骤之后](https://github.com/appsignal/mono/#installation)。 。 。 .

然后安装依赖性,并用单项为开发用途准备项目:

```bash
mono bootstrap
```

您可以运行以下操作以启动编译器 _监视_ 模式.

```bash
npm run build:watch --parallel
```

您也可以不查看目录而构建库 :

```bash
mono build
```

提供了版本管理配置 [`asdf`](https://github.com/asdf-vm/asdf-nodejs)。 。 。 .

### 测试

此库的测试 [欢乐](https://jestjs.io/) 作为测试跑者。 一旦您安装了依赖性, 您可以在这个寄存器的根部运行以下命令来运行所有软件包的测试, 或者在只运行与该软件包有关的测试的软件包目录中运行 :

```bash
mono test
```

## 捐款

考虑为这次再投资做贡献? 赞

请跟我们走 [贡献指南](http://docs.appsignal.com/appsignal/contributing.html) 我们的文件,并跟着我们 [行为守则](https://docs.appsignal.com/appsignal/code-of-conduct.html)。 。 。 .

还有,我们很乐意送你们去斯特罗普瓦费斯 看看每个人,我们发送一个包裹 到目前为止,我们 [Stroopwafels 页面](https://www.appsignal.com/waffles)。 。 。 .

## 支助

[联系我们](mailto:support@appsignal.com) 直接和AppSignal的工程师交谈 他们会帮助你得到设置, 调整你的代码 并确保你得到最多的 使用AppSignal.

## 常见问题

### @appsignal/nodejs 是什么？

AppSignal for Node\.js 图书馆\.

### 如何安装 @appsignal/nodejs？

在项目目录运行 npm install @appsignal/nodejs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 appsignal-diagnose，可以用 npx appsignal-diagnose 直接运行。

### @appsignal/nodejs 支持 TypeScript 吗？

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

### @appsignal/nodejs 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @appsignal/nodejs 需要什么版本的 Node\.js？

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

### @appsignal/nodejs 可以商用吗？

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

### @appsignal/nodejs 的下载量有多少？

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

### @appsignal/nodejs 还在维护吗？

最新版本 3\.9\.4 发布于 2026/10/23（15 天前）；至今共发布 154 个版本，其中过去 12 个月发布了 8 个；首次发布于 2020/01/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。