# @jridgewell/sourcemap-codec 中文文档 规范地址：https://npmcn.com/package/%40jridgewell/sourcemap-codec/ 版本：1\.6\.0 npm 元数据更新时间：2026-08-28T01:14:47.463Z 中文译文更新时间：2026-11-04T13:09:10.325Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40jridgewell/sourcemap-codec 原文对照：https://npmcn.com/package/%40jridgewell/sourcemap-codec/?lang=original 项目主页：https://github.com/jridgewell/sourcemaps/tree/main/packages/sourcemap-codec 源码仓库：https://github.com/jridgewell/sourcemaps ## 关键信息（来自 npm 元数据） - 包体积（解压后）：96.6 kB，32 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - 首次发布：2022-02-05T04:51:19.696Z - 最新版本发布：2026-08-28T01:14:47.331Z - 近 30 天下载量：986068397（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：16（近 12 个月 2 个） ## 中文简介 编码/解码源映射映射 ## 安装 ```sh npm install @jridgewell/sourcemap-codec ``` 也可以使用：`pnpm add @jridgewell/sourcemap-codec`、`yarn add @jridgewell/sourcemap-codec`、`bun add @jridgewell/sourcemap-codec` ## README # @jridgewell / sourcemap-codec 编码/解码 `mappings` a的性质 [sourcemap](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit)。 ## 为什么? 源地图很难生成和操作，因为 `mappings` 属性——实际将生成的代码链接回原始源代码的部分——使用名为 [变长量](https://en.wikipedia.org/wiki/Variable-length_quantity)． 最重要的是，映射中的每个段都包含偏移量而不是绝对索引，这意味着您不能孤立地查看段-您必须了解整个源图。 这个包使这个过程稍微容易一些。 ## 安装 ```bash npm install @jridgewell/sourcemap-codec ``` ## 用法 ```js import { encode, decode } from '@jridgewell/sourcemap-codec'; var decoded = decode( ';EAEEA,EAAE,EAAC,CAAE;ECQY,UACC' ); assert.deepEqual( decoded, [ // the first line (of the generated code) has no mappings, // as shown by the starting semi-colon (which separates lines) [], // the second line contains four (comma-separated) segments [ // segments are encoded as you'd expect: // [ generatedCodeColumn, sourceIndex, sourceCodeLine, sourceCodeColumn, nameIndex ] // i.e. the first segment begins at column 2, and maps back to the second column // of the second line (both zero-based) of the 0th source, and uses the 0th // name in the `map.names` array [ 2, 0, 2, 2, 0 ], // the remaining segments are 4-length rather than 5-length, // because they don't map a name [ 4, 0, 2, 4 ], [ 6, 0, 2, 5 ], [ 7, 0, 2, 7 ] ], // the final line contains two segments [ [ 2, 1, 10, 19 ], [ 12, 1, 11, 20 ] ] ]); var encoded = encode( decoded ); assert.equal( encoded, ';EAEEA,EAAE,EAAC,CAAE;ECQY,UACC' ); ``` ## 基准 ``` node v20.10.0 amp.js.map - 45120 segments Decode Memory Usage: local code 5815135 bytes @jridgewell/sourcemap-codec 1.4.15 5868160 bytes sourcemap-codec 5492584 bytes source-map-0.6.1 13569984 bytes source-map-0.8.0 6390584 bytes chrome dev tools 8011136 bytes Smallest memory usage is sourcemap-codec Decode speed: decode: local code x 492 ops/sec ±1.22% (90 runs sampled) decode: @jridgewell/sourcemap-codec 1.4.15 x 499 ops/sec ±1.16% (89 runs sampled) decode: sourcemap-codec x 376 ops/sec ±1.66% (89 runs sampled) decode: source-map-0.6.1 x 34.99 ops/sec ±0.94% (48 runs sampled) decode: source-map-0.8.0 x 351 ops/sec ±0.07% (95 runs sampled) chrome dev tools x 165 ops/sec ±0.91% (86 runs sampled) Fastest is decode: @jridgewell/sourcemap-codec 1.4.15 Encode Memory Usage: local code 444248 bytes @jridgewell/sourcemap-codec 1.4.15 623024 bytes sourcemap-codec 8696280 bytes source-map-0.6.1 8745176 bytes source-map-0.8.0 8736624 bytes Smallest memory usage is local code Encode speed: encode: local code x 796 ops/sec ±0.11% (97 runs sampled) encode: @jridgewell/sourcemap-codec 1.4.15 x 795 ops/sec ±0.25% (98 runs sampled) encode: sourcemap-codec x 231 ops/sec ±0.83% (86 runs sampled) encode: source-map-0.6.1 x 166 ops/sec ±0.57% (86 runs sampled) encode: source-map-0.8.0 x 203 ops/sec ±0.45% (88 runs sampled) Fastest is encode: local code,encode: @jridgewell/sourcemap-codec 1.4.15 *** babel.min.js.map - 347793 segments Decode Memory Usage: local code 35424960 bytes @jridgewell/sourcemap-codec 1.4.15 35424696 bytes sourcemap-codec 36033464 bytes source-map-0.6.1 62253704 bytes source-map-0.8.0 43843920 bytes chrome dev tools 45111400 bytes Smallest memory usage is @jridgewell/sourcemap-codec 1.4.15 Decode speed: decode: local code x 38.18 ops/sec ±5.44% (52 runs sampled) decode: @jridgewell/sourcemap-codec 1.4.15 x 38.36 ops/sec ±5.02% (52 runs sampled) decode: sourcemap-codec x 34.05 ops/sec ±4.45% (47 runs sampled) decode: source-map-0.6.1 x 4.31 ops/sec ±2.76% (15 runs sampled) decode: source-map-0.8.0 x 55.60 ops/sec ±0.13% (73 runs sampled) chrome dev tools x 16.94 ops/sec ±3.78% (46 runs sampled) Fastest is decode: source-map-0.8.0 Encode Memory Usage: local code 2606016 bytes @jridgewell/sourcemap-codec 1.4.15 2626440 bytes sourcemap-codec 21152576 bytes source-map-0.6.1 25023928 bytes source-map-0.8.0 25256448 bytes Smallest memory usage is local code Encode speed: encode: local code x 127 ops/sec ±0.18% (83 runs sampled) encode: @jridgewell/sourcemap-codec 1.4.15 x 128 ops/sec ±0.26% (83 runs sampled) encode: sourcemap-codec x 29.31 ops/sec ±2.55% (53 runs sampled) encode: source-map-0.6.1 x 18.85 ops/sec ±3.19% (36 runs sampled) encode: source-map-0.8.0 x 19.34 ops/sec ±1.97% (36 runs sampled) Fastest is encode: @jridgewell/sourcemap-codec 1.4.15 *** preact.js.map - 1992 segments Decode Memory Usage: local code 261696 bytes @jridgewell/sourcemap-codec 1.4.15 244296 bytes sourcemap-codec 302816 bytes source-map-0.6.1 939176 bytes source-map-0.8.0 336 bytes chrome dev tools 587368 bytes Smallest memory usage is source-map-0.8.0 Decode speed: decode: local code x 17,782 ops/sec ±0.32% (97 runs sampled) decode: @jridgewell/sourcemap-codec 1.4.15 x 17,863 ops/sec ±0.40% (100 runs sampled) decode: sourcemap-codec x 12,453 ops/sec ±0.27% (101 runs sampled) decode: source-map-0.6.1 x 1,288 ops/sec ±1.05% (96 runs sampled) decode: source-map-0.8.0 x 9,289 ops/sec ±0.27% (101 runs sampled) chrome dev tools x 4,769 ops/sec ±0.18% (100 runs sampled) Fastest is decode: @jridgewell/sourcemap-codec 1.4.15 Encode Memory Usage: local code 262944 bytes @jridgewell/sourcemap-codec 1.4.15 25544 bytes sourcemap-codec 323048 bytes source-map-0.6.1 507808 bytes source-map-0.8.0 507480 bytes Smallest memory usage is @jridgewell/sourcemap-codec 1.4.15 Encode speed: encode: local code x 24,207 ops/sec ±0.79% (95 runs sampled) encode: @jridgewell/sourcemap-codec 1.4.15 x 24,288 ops/sec ±0.48% (96 runs sampled) encode: sourcemap-codec x 6,761 ops/sec ±0.21% (100 runs sampled) encode: source-map-0.6.1 x 5,374 ops/sec ±0.17% (99 runs sampled) encode: source-map-0.8.0 x 5,633 ops/sec ±0.32% (99 runs sampled) Fastest is encode: @jridgewell/sourcemap-codec 1.4.15,encode: local code *** react.js.map - 5726 segments Decode Memory Usage: local code 678816 bytes @jridgewell/sourcemap-codec 1.4.15 678816 bytes sourcemap-codec 816400 bytes source-map-0.6.1 2288864 bytes source-map-0.8.0 721360 bytes chrome dev tools 1012512 bytes Smallest memory usage is local code Decode speed: decode: local code x 6,178 ops/sec ±0.19% (98 runs sampled) decode: @jridgewell/sourcemap-codec 1.4.15 x 6,261 ops/sec ±0.22% (100 runs sampled) decode: sourcemap-codec x 4,472 ops/sec ±0.90% (99 runs sampled) decode: source-map-0.6.1 x 449 ops/sec ±0.31% (95 runs sampled) decode: source-map-0.8.0 x 3,219 ops/sec ±0.13% (100 runs sampled) chrome dev tools x 1,743 ops/sec ±0.20% (99 runs sampled) Fastest is decode: @jridgewell/sourcemap-codec 1.4.15 Encode Memory Usage: local code 140960 bytes @jridgewell/sourcemap-codec 1.4.15 159808 bytes sourcemap-codec 969304 bytes source-map-0.6.1 930520 bytes source-map-0.8.0 930248 bytes Smallest memory usage is local code Encode speed: encode: local code x 8,013 ops/sec ±0.19% (100 runs sampled) encode: @jridgewell/sourcemap-codec 1.4.15 x 7,989 ops/sec ±0.20% (101 runs sampled) encode: sourcemap-codec x 2,472 ops/sec ±0.21% (99 runs sampled) encode: source-map-0.6.1 x 2,200 ops/sec ±0.17% (99 runs sampled) encode: source-map-0.8.0 x 2,220 ops/sec ±0.37% (99 runs sampled) Fastest is encode: local code *** vscode.map - 2141001 segments Decode Memory Usage: local code 198955264 bytes @jridgewell/sourcemap-codec 1.4.15 199175352 bytes sourcemap-codec 199102688 bytes source-map-0.6.1 386323432 bytes source-map-0.8.0 244116432 bytes chrome dev tools 293734280 bytes Smallest memory usage is local code Decode speed: decode: local code x 3.90 ops/sec ±22.21% (15 runs sampled) decode: @jridgewell/sourcemap-codec 1.4.15 x 3.95 ops/sec ±23.53% (15 runs sampled) decode: sourcemap-codec x 3.82 ops/sec ±17.94% (14 runs sampled) decode: source-map-0.6.1 x 0.61 ops/sec ±7.81% (6 runs sampled) decode: source-map-0.8.0 x 9.54 ops/sec ±0.28% (28 runs sampled) chrome dev tools x 2.18 ops/sec ±10.58% (10 runs sampled) Fastest is decode: source-map-0.8.0 Encode Memory Usage: local code 13509880 bytes @jridgewell/sourcemap-codec 1.4.15 13537648 bytes sourcemap-codec 32540104 bytes source-map-0.6.1 127531040 bytes source-map-0.8.0 127535312 bytes Smallest memory usage is local code Encode speed: encode: local code x 20.10 ops/sec ±0.19% (38 runs sampled) encode: @jridgewell/sourcemap-codec 1.4.15 x 20.26 ops/sec ±0.32% (38 runs sampled) encode: sourcemap-codec x 5.44 ops/sec ±1.64% (18 runs sampled) encode: source-map-0.6.1 x 2.30 ops/sec ±4.79% (10 runs sampled) encode: source-map-0.8.0 x 2.46 ops/sec ±6.53% (10 runs sampled) Fastest is encode: @jridgewell/sourcemap-codec 1.4.15 ``` # 许可证 麻省理工学院 ## 常见问题 ### @jridgewell/sourcemap-codec 是什么？ 编码/解码源映射映射 ### 如何安装 @jridgewell/sourcemap-codec？ 在项目目录运行 npm install @jridgewell/sourcemap-codec，或使用 pnpm add / yarn add / bun add。 ### @jridgewell/sourcemap-codec 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @jridgewell/sourcemap-codec 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @jridgewell/sourcemap-codec 可以商用吗？ @jridgewell/sourcemap-codec 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @jridgewell/sourcemap-codec 的下载量有多少？ 根据 npm 官方下载统计，@jridgewell/sourcemap-codec 在 2026/10/05 – 2026/11/03 这 30 天内被下载 986,068,397 次，日均约 32,868,947 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @jridgewell/sourcemap-codec 还在维护吗？ 最新版本 1\.6\.0 发布于 2026/08/28（2 个月前）；至今共发布 16 个版本，其中过去 12 个月发布了 2 个；首次发布于 2022/02/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。