# @-xun/debug 中文文档

规范地址：https://npmcn.com/package/%40-xun/debug/

版本：2\.0\.2
npm 元数据更新时间：2025-08-26T08:42:35.249Z
中文译文更新时间：2026-11-05T17:29:06.819Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40-xun/debug
原文对照：https://npmcn.com/package/%40-xun/debug/?lang=original
项目主页：https://github.com/Xunnamius/rejoinder/tree/main/packages/debug#readme
源码仓库：https://github.com/Xunnamius/rejoinder

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

- 包体积（解压后）：21.4 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：^20\.18\.0 \|\| ^22\.12\.0 \|\| \>=23\.3\.0
- 运行依赖：4 个
- 首次发布：2025-01-09T10:14:32.729Z
- 最新版本发布：2025-08-26T08:42:35.043Z
- 近 30 天下载量：311143（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 0 个）

## 中文简介

用几种方便方法扩展超流行调试包

## 安装

```sh
npm install @-xun/debug
```

也可以使用：`pnpm add @-xun/debug`、`yarn add @-xun/debug`、`bun add @-xun/debug`

## README

![](https://raw.githubusercontent.com/Xunnamius/rejoinder/refs/heads/main/packages/debug/logo.png)

扩展超流行 `debug` 包含几种便利方法的软件包

* * *

[![Black Lives Matter!](https://xunn.at/badge-blm "Join the movement!")](https://xunn.at/donate-blm) [![Last commit timestamp](https://img.shields.io/github/last-commit/Xunnamius/rejoinder?style=flat-square "Latest commit timestamp")](https://github.com/Xunnamius/rejoinder) [![Codecov](https://img.shields.io/codecov/c/github/Xunnamius/rejoinder/main?style=flat-square&token=HWRIOBAAPW&flag=package.main_debug "Is this package well-tested?")](https://codecov.io/gh/Xunnamius/rejoinder) [![Source license](https://img.shields.io/npm/l/@-xun/debug?style=flat-square "This package's source license")](https://github.com/Xunnamius/rejoinder/blob/main/LICENSE) [![Uses Semantic Release!](https://xunn.at/badge-semantic-release "This repo practices continuous integration and deployment!")](https://github.com/semantic-release/semantic-release)

[![NPM version](https://xunn.at/npm-pkg-version/@-xun/debug "Install this package using npm or yarn!")](https://npm.im/@-xun/debug) [![Monthly Downloads](https://img.shields.io/npm/dm/@-xun/debug?style=flat-square "Number of times this package has been downloaded per month")](https://npmtrends.com/@-xun/debug)

  

# @-xun/调试

`@-xun/debug` 扩展超受欢迎的调试器实例 `debug` 软件包 有几种方便方法.

这个包是工作马 上面 [`rejoinder`](https://github.com/Xunnamius/rejoinder#readme) 已经建成.

* * *

-   [安装](https://npmcn.com/package/%40-xun/debug/#readme-install)
-   [使用量](https://npmcn.com/package/%40-xun/debug/#readme-usage)
-   [附 录](https://npmcn.com/package/%40-xun/debug/#readme-appendix)
    -   [已发布软件包细节](https://npmcn.com/package/%40-xun/debug/#readme-published-package-details)
    -   [许可证](https://npmcn.com/package/%40-xun/debug/#readme-license)
-   [捐助和支助](https://npmcn.com/package/%40-xun/debug/#readme-contributing-and-support)
    -   [贡献者](https://npmcn.com/package/%40-xun/debug/#readme-contributors)

  

## 安装

要安装 :

```shell
npm install @-xun/debug
```

## 使用量

> \[TIP\]
> 
> 这是一个低等包。 你也许想要 [`rejoinder`](https://github.com/Xunnamius/rejoinder#readme) 换句话说.

`@-xun/debug`作为包装 `debug` 软件包,并共享其全部 特性; 见 [`debug`文档](https://npm.im/debug) 详细情况.

TODO: 文档新功能 `@-xun/debug` 那个 `debug` 缺少(用于 现在,看 [`docs/`](https://npmcn.com/package/%40-xun/debug/docs)) (中文(简体) ).

## 附 录

进一步文件见下面 [`docs/`](https://npmcn.com/package/%40-xun/debug/docs)。 。 。 .

### 已发布软件包细节

这是一个 [CJS2 软件包](https://dev.to/jakobjingleheimer/configuring-commonjs-es-modules-for-nodejs-12ed#publish-only-a-cjs-distribution-with-property-exports) 有静态分析的出口 由 Babel 所建,用于Node.js 版本中不为报废. 对于 TypeScript 用户, 此软件包支持两者 `"Node10"` 财务报告和审定财务报表 `"Node16"` 模块 决议战略.

扩展细节

这意味着CJS2(通过 `require(...)`和无害环境管理(通过 `import { ... } from ...` 或者说 `await import(...)`) 源会从相同的切入点装入此包 当使用节点时。 这有几个好处,首先是: 代码少一点 已运出/ 较小的软件包大小, 避免 [双套件 危险](https://nodejs.org/api/packages.html#dual-package-hazard) 完全,分配不是 包装/捆绑/放大,一个复杂程度大大降低的建造过程,以及CJS 消费者不是被骗的.

每个出入口(即:. `ENTRY`(单位:千美元) [`package.json`是因为 `exports[ENTRY]`](https://npmcn.com/package/%40-xun/debug/package.json) 对象包括一个或多个 [导出 条件](https://webpack.js.org/guides/package-exports#reference-syntax)。这些条目可能包括也可能不包括: [`exports[ENTRY].types`](https://devblogs.microsoft.com/typescript/announcing-typescript-4-5-beta#packagejson-exports-imports-and-self-referencing) 指向类型的条件 typeScript 和 IDEs 的声明文件, a [`exports[ENTRY].module`](https://webpack.js.org/guides/package-exports#providing-commonjs-and-esm-version-stateless) 条件指向 (通常是无害环境管理) Webpack/Rollup 源,a `exports[ENTRY].node` 和(或) `exports[ENTRY].default` 指向(通常是CJS2)节点源的条件 `require`编号 :`import` 用于浏览器和其他环境,以及 [其他项目 条件](https://webpack.js.org/guides/package-exports#reference-syntax) 这里没有列出。 检查 [软件包.json](https://npmcn.com/package/%40-xun/debug/package.json) 要查看哪些导出条件的文件 已支持.

请注意,无论 [`{ "type": "..." }`](https://github.com/nodejs/node/blob/8d8e06a345043bec787e904edc9a2f5c5e9c275f/doc/api/packages.md#type) 指定于 [`package.json`](https://npmcn.com/package/%40-xun/debug/package.json),任何在无害环境管理中写的 JavaScript 文件 语法(包括分配)将永远具有 `.mjs` 扩展名。 说明 并且 [`package.json`](https://npmcn.com/package/%40-xun/debug/package.json) 可能包括 [`sideEffects`](https://webpack.js.org/guides/tree-shaking#mark-the-file-as-side-effect-free) 键,几乎总是 `false` 页:1 最佳 [树摇晃](https://webpack.js.org/guides/tree-shaking) 在适当情况下.

### 许可证

见 [自由主义](https://npmcn.com/package/%40-xun/debug/LICENSE)。 。 。 .

## 捐助和支助

**[二. 新问题](https://github.com/Xunnamius/rejoinder/issues/new/choose) 财务报告和审定财务报表 [拖动请求](https://github.com/Xunnamius/rejoinder/compare) 永远欢迎和赞赏** 你也一样 [明星们.. 这个项目](https://github.com/Xunnamius/rejoinder) 让我知道你觉得有用! 或者说 [购买 给我一瓶啤酒](https://github.com/sponsors/Xunnamius)我会很感激的 谢谢!

见 [捐款额](https://npmcn.com/CONTRIBUTING.md) 财务报告和审定财务报表 [支助](https://npmcn.com/.github/SUPPORT.md) 页:1 更多信息.

### 贡献者

见 [捐款者表](https://npmcn.com/README.md#contributors)。 。 。 .

## 常见问题

### @-xun/debug 是什么？

用几种方便方法扩展超流行调试包

### 如何安装 @-xun/debug？

在项目目录运行 npm install @-xun/debug，或使用 pnpm add / yarn add / bun add。

### @-xun/debug 支持 TypeScript 吗？

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

### @-xun/debug 支持 ESM 还是 CommonJS？

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

### @-xun/debug 需要什么版本的 Node\.js？

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

### @-xun/debug 可以商用吗？

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

### @-xun/debug 的下载量有多少？

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

### @-xun/debug 还在维护吗？

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