# @geoman-io/leaflet-geoman-free 中文文档

规范地址：https://npmcn.com/package/%40geoman-io/leaflet-geoman-free/

版本：2\.20\.6
npm 元数据更新时间：2026-11-04T20:48:14.092Z
中文译文更新时间：2026-11-16T04:29:04.527Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：4 MB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：6 个
- peer 依赖：leaflet ^1\.2\.0
- 首次发布：2019-09-29T16:45:08.454Z
- 最新版本发布：2026-11-04T20:48:13.757Z
- 近 30 天下载量：1161631（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 11 个）

## 中文简介

用于编辑叶片1.0中的几何图层的叶片插件

## 安装

```sh
npm install @geoman-io/leaflet-geoman-free
```

也可以使用：`pnpm add @geoman-io/leaflet-geoman-free`、`yarn add @geoman-io/leaflet-geoman-free`、`bun add @geoman-io/leaflet-geoman-free`

## README

[![Geoman Logo](https://assets.geoman.io/assets/logo_white_bg.svg)](https://geoman.io/)

# 莱弗莱-吉奥曼

**创建和编辑几何图层的叶片插件**  
绘制、编辑、拖放、剪切、旋转、分块、缩放、度量、收缩和平面图层  
支持标记、 CircleMarkers 、 多线、 多边形、 圆形、 矩形、 图像覆盖、 层组、 GeoJSON、 多线串和多波利根

 [![npm version](https://badge.fury.io/js/%40geoman-io%2Fleaflet-geoman-free.svg)](https://badge.fury.io/js/%40geoman-io%2Fleaflet-geoman-free)[![](https://github.com/geoman-io/leaflet-geoman/workflows/Tests/badge.svg) ](https://npmcn.com/package/%40geoman-io/leaflet-geoman-free/#)[![NPM Downloads](https://img.shields.io/npm/dt/@geoman-io/leaflet-geoman-free.svg)](https://www.npmjs.com/package/@geoman-io/leaflet-geoman-free)

![Demo](https://assets.geoman.io/assets/draw-example.png)

## 文档

访问 [地质学家.io/文件](https://www.geoman.io/docs) 要开始.

## 演示

看看Leaflet-Geoman Pro的全能性能 [地质学家.io/demo](https://www.geoman.io/demo)

### 特性请求

我采用了"Lodash的发行管理",意思是,功能请求得到"Feature Request"标签,然后关闭.  
您可以对已有的功能请求( 或创建新功能请求) 进行投票 。 Upvotes让我看看需要多少功能并优先执行.  
请参看现有的 [这里的特性请求](https://github.com/geoman-io/leaflet-geoman/issues?q=is%3Aissue+is%3Aclosed+label%3A%22feature+request%22+sort%3Areactions-%2B1-desc) 如果想要执行的话,请投票.

### 发展中国家

这个项目使用 [爱](https://mise.jdx.dev/) {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}把Node.js和pnpm钉上 克隆 ,然后安装所有软件包:

```
mise install
pnpm install
```

编译并运行 `dev` 监视版本 :

```
pnpm start
```

编译并运行 `build` 版本 :

```
pnpm run prepare
```

运行测试 :

```
pnpm test            # E2E tests (Cypress)
pnpm run test:unit   # Unit tests (Vitest)
```

打开 cypress 窗口 :

```
pnpm run cypress
```

林特和格式( oxlint + oxfmt):

```
pnpm run lint
```

仔细看看 [捐款](https://npmcn.com/package/%40geoman-io/leaflet-geoman-free/CONTRIBUTING.md)

### 信贷

感谢@Falke-Design,他投入了大量时间,并很好地照顾了Leaflet-Geoman.

感谢@ryan-morris 执行 Typescript 和支持 Typescript 问题.

由于我以前从未建过传单插件,我认真研究了传单的代码。 画画找出如何做的东西。 所以不要惊讶地看到一些熟悉的代码.

我也仔细看了一下伟大的 [L. 几何Util](https://github.com/makinacorpus/Leaflet.GeometryUtil) 我的一些助手职能.

旋转模式之所以有效,只是因为 [(原始内容存档于2012-10-10). L.Path. 变形](https://github.com/w8r/Leaflet.Path.Transform)

## 常见问题

### @geoman-io/leaflet-geoman-free 是什么？

用于编辑叶片1\.0中的几何图层的叶片插件

### 如何安装 @geoman-io/leaflet-geoman-free？

在项目目录运行 npm install @geoman-io/leaflet-geoman-free，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：leaflet（^1\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @geoman-io/leaflet-geoman-free 支持 TypeScript 吗？

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

### @geoman-io/leaflet-geoman-free 支持 ESM 还是 CommonJS？

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

### @geoman-io/leaflet-geoman-free 需要什么版本的 Node\.js？

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

### @geoman-io/leaflet-geoman-free 可以商用吗？

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

### @geoman-io/leaflet-geoman-free 的下载量有多少？

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

### @geoman-io/leaflet-geoman-free 还在维护吗？

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

