# @carto/kepler\.gl 中文文档

规范地址：https://npmcn.com/package/%40carto/kepler.gl/

版本：0\.0\.89
npm 元数据更新时间：2026-10-27T14:32:04.452Z
中文译文更新时间：2026-11-09T05:20:48.623Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：13.6 MB，1312 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：74 个
- peer 依赖：react \>=16\.3，react-dom \>=16\.3，@deck\.gl/core ^9\.1\.2，@luma\.gl/core ^9\.1\.2，@deck\.gl/carto ^9\.1\.2，@deck\.gl/react ^9\.1\.2，@luma\.gl/webgl ^9\.1\.2，@deck\.gl/layers ^9\.1\.2，@loaders\.gl/csv ^4\.2\.5，@loaders\.gl/core ^4\.2\.5，@loaders\.gl/gltf ^4\.2\.5，@loaders\.gl/json ^4\.2\.5，styled-components ^4\.x \|\| ^5\.x，@luma\.gl/constants ^9\.1\.2，@deck\.gl/extensions ^9\.1\.2，@deck\.gl/geo-layers ^9\.1\.2，@deck\.gl/mesh-layers ^9\.1\.2，@loaders\.gl/loader-utils ^4\.2\.5，@deck\.gl/aggregation-layers ^9\.1\.2
- 首次发布：2021-09-03T07:35:38.470Z
- 最新版本发布：2026-10-27T14:32:04.230Z
- 近 30 天下载量：7877（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：233（近 12 个月 2 个）

## 中文简介

kepler.gl是一个基于webgl的应用程序,用于可视化浏览器中的大尺度位置数据

## 安装

```sh
npm install @carto/kepler.gl
```

也可以使用：`pnpm add @carto/kepler.gl`、`yarn add @carto/kepler.gl`、`bun add @carto/kepler.gl`

## README

# CARTO 叉号 [开普勒.gl](http://www.kepler.gl/)

发表于 [`@carto/kepler.gl`](https://www.npmjs.com/package/@carto/kepler.gl),被"云原"应用程序所使用.

## 发展进程

### 调取请求

-   每项开发均应在自己的特色部门进行
    
-   牵引请求应该与 `main` 分支
    
-   除了代码更改外,PR还应在"未放出"一栏中加入一个条目 `CHANGELOG.md` 带有链接到自身(如果部分不在场,则在文件顶端重新创建). 这有利于发布进程,使更改日志随时更新 `main`。 。 。 .
    
    实例:
    
    ```md
    ## Not released
    
    - Support for count aggregation [141](https://github.com/CartoDB/carto-kepler/pull/141)
    ```
    
-   审查后,合并到 `main` 通过打压树枝 承诺,保持一个干净的历史.
    

### 与云土著一起发展

当本地开发时, 您可以使用同名链接连接本地的 CARTO Kepler :

1.  在卡通-克普勒中: `yarn link`
2.  在云内: `yarn link @carto/kepler.gl`
3.  在卡通-克普勒中: `yarn build:watch`
4.  在云内: `yarn start`

### Dev 预放

要能在远程环境(如:QA专用环境)上从云端测试出一德维版本的carto-kepler,需要发布一款α版本的carto-kepler.

1.  切换到您想要发布的分支 。 你可以使用任何未合并的 dev 分支, 但要确保它是基于最新的 `main` 以避免分支范围之外的行为变化.
    
2.  手动更改版本 `package.json`。使用此模式: `<next-version>-alpha.<feature>`。 。 。 .
    
    实例: `0.0.47-alpha.custom-markers`
    
3.  以 `yarn build`,并确保没有出错.
    
4.  将软件包作为α发布给国家预防机制。 你需要在国家预防机制组织中拥有适当的权利.
    
    ```
    npm publish --tag alpha
    ```
    
5.  如果软件包已经正确发布, 那么在 `cloud-native` 将新版本安装为 `yarn add @carto/kepler.gl@<alpha-version-number>`打开公关.
    

如果你需要修改一些 稍后代码,你需要重写。 通过简单地在版本编号中添加后缀来重复这一过程.

实例: `0.0.47-alpha.custom-markers.2`

## 稳定释放进程

1.  创建分支 `release-<next-version>` 从最新变化起 `main`。 。 。 .
    
2.  修改 `CHANGELOG.md` 文件,通过创建新区域 `<next-version>` 并将内容从"未放出"移动到它。 将空出"不放出"部分保留在文件上方.
    
3.  增加版本在 `package.json` 改为 `<next-version>`
    
4.  以 `yarn build`,并确保没有出错.
    
5.  提交更改( N)`git commit -am "release <next-version>"`),推出,打开公关,要求复核并合并.
    
6.  最后改为: `main` 向国家预防机制公布
    
    ```
    npm publish --access public
    ```

## 常见问题

### @carto/kepler\.gl 是什么？

kepler\.gl是一个基于webgl的应用程序,用于可视化浏览器中的大尺度位置数据

### 如何安装 @carto/kepler\.gl？

在项目目录运行 npm install @carto/kepler\.gl，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16\.3）、react-dom（\>=16\.3）、@deck\.gl/core（^9\.1\.2）、@luma\.gl/core（^9\.1\.2）、@deck\.gl/carto（^9\.1\.2）、@deck\.gl/react（^9\.1\.2）、@luma\.gl/webgl（^9\.1\.2）、@deck\.gl/layers（^9\.1\.2）、@loaders\.gl/csv（^4\.2\.5）、@loaders\.gl/core（^4\.2\.5）、@loaders\.gl/gltf（^4\.2\.5）、@loaders\.gl/json（^4\.2\.5）、styled-components（^4\.x \|\| ^5\.x）、@luma\.gl/constants（^9\.1\.2）、@deck\.gl/extensions（^9\.1\.2）、@deck\.gl/geo-layers（^9\.1\.2）、@deck\.gl/mesh-layers（^9\.1\.2）、@loaders\.gl/loader-utils（^4\.2\.5）、@deck\.gl/aggregation-layers（^9\.1\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @carto/kepler\.gl 支持 TypeScript 吗？

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

### @carto/kepler\.gl 支持 ESM 还是 CommonJS？

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

### @carto/kepler\.gl 可以商用吗？

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

### @carto/kepler\.gl 的下载量有多少？

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

### @carto/kepler\.gl 还在维护吗？

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