# unist-util-stringify-position 中文文档

规范地址：https://npmcn.com/package/unist-util-stringify-position/

版本：4\.0\.0
npm 元数据更新时间：2023-07-07T10:09:27.027Z
中文译文更新时间：2026-11-05T15:46:27.042Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/unist-util-stringify-position
原文对照：https://npmcn.com/package/unist-util-stringify-position/?lang=original
项目主页：https://github.com/syntax-tree/unist-util-stringify-position#readme
源码仓库：https://github.com/syntax-tree/unist-util-stringify-position

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

- 包体积（解压后）：13.2 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2016-04-16T10:20:49.740Z
- 最新版本发布：2023-07-07T10:09:26.763Z
- 近 30 天下载量：293237719（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 0 个）

## 中文简介

将一个节点、位置或点作为人类可读位置进行序列化的无源工具

## 安装

```sh
npm install unist-util-stringify-position
```

也可以使用：`pnpm add unist-util-stringify-position`、`yarn add unist-util-stringify-position`、`bun add unist-util-stringify-position`

## README

# 非斜- 斜- 字符串- 位置

[![Build](https://github.com/syntax-tree/unist-util-stringify-position/workflows/main/badge.svg)](https://github.com/syntax-tree/unist-util-stringify-position/actions) [![Coverage](https://img.shields.io/codecov/c/github/syntax-tree/unist-util-stringify-position.svg)](https://codecov.io/github/syntax-tree/unist-util-stringify-position) [![Downloads](https://img.shields.io/npm/dm/unist-util-stringify-position.svg)](https://www.npmjs.com/package/unist-util-stringify-position) [![Size](https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=unist-util-stringify-position)](https://bundlejs.com/?q=unist-util-stringify-position) [![Sponsors](https://opencollective.com/unified/sponsors/badge.svg)](https://opencollective.com/unified) [![Backers](https://opencollective.com/unified/backers/badge.svg)](https://opencollective.com/unified) [![Chat](https://img.shields.io/badge/chat-discussions-success.svg)](https://github.com/syntax-tree/unist/discussions)

[无符号](https://github.com/syntax-tree/unist) 用于相当打印节点位置信息.

## 目录

-   [这是什么?](https://npmcn.com/package/unist-util-stringify-position/#readme-what-is-this)
-   [我什么时候用这个?](https://npmcn.com/package/unist-util-stringify-position/#readme-when-should-i-use-this)
-   [安装](https://npmcn.com/package/unist-util-stringify-position/#readme-install)
-   [使用](https://npmcn.com/package/unist-util-stringify-position/#readme-use)
-   [API 密码](https://npmcn.com/package/unist-util-stringify-position/#readme-api)
    -   [`stringifyPosition(node|position|point)`](https://npmcn.com/package/unist-util-stringify-position/#readme-stringifypositionnodepositionpoint)
-   [类型](https://npmcn.com/package/unist-util-stringify-position/#readme-types)
-   [兼容性](https://npmcn.com/package/unist-util-stringify-position/#readme-compatibility)
-   [警卫](https://npmcn.com/package/unist-util-stringify-position/#readme-security)
-   [相关](https://npmcn.com/package/unist-util-stringify-position/#readme-related)
-   [贡献](https://npmcn.com/package/unist-util-stringify-position/#readme-contribute)
-   [许可证](https://npmcn.com/package/unist-util-stringify-position/#readme-license)

## 这是什么?

此软件包是使用任何 [无符号](https://github.com/syntax-tree/unist) (无论mdast, hast等) 节点,位置,或指点,并将其位置信息序列化.

## 我什么时候用这个?

此工具可用于显示原文件中发生的东西 用一种标准方式为人类提供文档. 例如,当抛出错误或警告某事时.

## 安装

这个软件包是 [仅限无害环境管理](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c)。 。 。 . 在Node.js(第16版+)中,安装为 [无](https://docs.npmjs.com/cli/install)数字 :

```sh
npm install unist-util-stringify-position
```

在德诺与 [`esm.sh`](https://esm.sh/)数字 :

```js
import {stringifyPosition} from 'https://esm.sh/unist-util-stringify-position@4'
```

在浏览器中 [`esm.sh`](https://esm.sh/)数字 :

```html
<script type="module">
  import {stringifyPosition} from 'https://esm.sh/unist-util-stringify-position@4?bundle'
</script>
```

## 使用

```js
import {stringifyPosition} from 'unist-util-stringify-position'

stringifyPosition({line: 2, column: 3}) // => '2:3' (point)
stringifyPosition({start: {line: 2}, end: {line: 3}}) // => '2:1-3:1' (position)
stringifyPosition({
  type: 'text',
  value: '!',
  position: {
    start: {line: 5, column: 11},
    end: {line: 5, column: 12}
  }
}) // => '5:11-5:12' (node)
```

## API 密码

此软件包导出标识符 [`stringifyPosition`](https://npmcn.com/package/unist-util-stringify-position/#readme-stringifypositionnodepositionpoint)。 。 。 . 没有默认导出 .

### `stringifyPosition(node|position|point)`

序列化一个点、位置(起点和终点)的位置信息,或 节点.

###### 参数

-   `node` (单位:千美元)[`Node`](https://github.com/syntax-tree/unist#node)(中文(简体) ) - 其节点 `position` 要序列化的字段
-   `position` (单位:千美元)[`Position`](https://github.com/syntax-tree/unist#position)(中文(简体) ) - 其职位 `start` 财务报告和审定财务报表 `end` 要序列化的点
-   `point` (单位:千美元)[`Point`](https://github.com/syntax-tree/unist#point)(中文(简体) ) - 指谁 `line` 财务报告和审定财务报表 `column` 要序列化的字段

###### 回返

相当印刷的节点位置信息( E)`string`) (中文(简体) ).

区域格式 `ls:cs-le:ce` (当给出时) `node` 或者说 `position`或一个 点 `l:c` (当给出时) `point`),在其中 `l` 代表线条, `c` 栏, `s` 页:1 `start`,以及 `e` 为了结束. 空字符串( E)`''`如果给定的值既不是,则返回 `node`, (中文(简体) ), `position`,则 `point`。 。 。 .

## 类型

此软件包已全部输入 [类型脚本](https://www.typescriptlang.org/)。 。 。 . 它不出口其他类型.

## 兼容性

由统一集体管理的项目与维持的项目兼容 (原始内容存档于2018-10-21). Executive of Node.js.

当我们剪下新的主要版本时,我们放弃了对未维护版本的支持 节点. 这意味着我们试图保持目前的释放线, `unist-util-stringify-position@^4`,与Node.js 16相兼容.

## 警卫

这个项目是安全的.

## 相关

-   [`unist-util-generated`](https://github.com/syntax-tree/unist-util-generated) ——检查是否生成了节点
-   [`unist-util-position`](https://github.com/syntax-tree/unist-util-position) 获取节点位置信息
-   [`unist-util-remove-position`](https://github.com/syntax-tree/unist-util-remove-position) - 从树上取出位置信息
-   [`unist-util-source`](https://github.com/syntax-tree/unist-util-source) ——在文件中获取一个值(节点或位置)的来源

## 贡献

见 [`contributing.md` 内 `syntax-tree/.github`](https://github.com/syntax-tree/.github/blob/main/contributing.md) 如何获得 开始 . 见 [`support.md`](https://github.com/syntax-tree/.github/blob/main/support.md) 为了寻求帮助.

这个项目有一个 [行为守则](https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md)。 。 。 . 通过与这个寄存器,组织或社区的互动,你同意 遵守它的规定.

## 许可证

[麻省理工学院](https://npmcn.com/package/unist-util-stringify-position/license) © [Titus 虫类](https://wooorm.com/)

## 常见问题

### unist-util-stringify-position 是什么？

将一个节点、位置或点作为人类可读位置进行序列化的无源工具

### 如何安装 unist-util-stringify-position？

在项目目录运行 npm install unist-util-stringify-position，或使用 pnpm add / yarn add / bun add。

### unist-util-stringify-position 支持 TypeScript 吗？

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

### unist-util-stringify-position 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### unist-util-stringify-position 可以商用吗？

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

### unist-util-stringify-position 的下载量有多少？

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

### unist-util-stringify-position 还在维护吗？

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