# @bishopbot/lightweight-charts 中文文档

规范地址：https://npmcn.com/package/%40bishopbot/lightweight-charts/

版本：6\.0\.1
npm 元数据更新时间：2026-10-31T15:59:53.977Z
中文译文更新时间：2026-10-31T16:24:16.704Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40bishopbot/lightweight-charts
原文对照：https://npmcn.com/package/%40bishopbot/lightweight-charts/?lang=original
项目主页：https://github.com/bishop-bot/lightweight-charts#readme
源码仓库：https://github.com/bishop-bot/lightweight-charts

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

- 包体积（解压后）：3.2 MB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-31T07:11:07.323Z
- 最新版本发布：2026-10-31T15:59:53.812Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

使用HTML5 canvas构建的高性能财务图表

## 安装

```sh
npm install @bishopbot/lightweight-charts
```

也可以使用：`pnpm add @bishopbot/lightweight-charts`、`yarn add @bishopbot/lightweight-charts`、`bun add @bishopbot/lightweight-charts`

## README

[![Lightweight Charts logo](https://github.com/bishop-bot/lightweight-charts/raw/master/.github/logo.svg?sanitize=true)](https://www.tradingview.com/lightweight-charts/)

# 轻量级的图表™

[![CircleCI](https://img.shields.io/circleci/build/github/bishop-bot/lightweight-charts.svg)](https://circleci.com/gh/bishop-bot/lightweight-charts) [![npm version](https://badge.fury.io/js/@bishopbot/lightweight-charts.svg)](https://www.npmjs.com/package/@bishopbot/lightweight-charts) [![npm bundle size](https://badgen.net/bundlephobia/minzip/@bishopbot/lightweight-charts)](https://bundlephobia.com/result?p=@bishopbot/lightweight-charts) [![Dependencies count](https://img.shields.io/badge/dynamic/json.svg?label=dependencies&color=brightgreen&query=$.dependencyCount&uri=https%3A%2F%2Fbundlephobia.com%2Fapi%2Fsize%3Fpackage%3D%40bishopbot%2Flightweight-charts)](https://bundlephobia.com/result?p=@bishopbot/lightweight-charts) [![Downloads](https://img.shields.io/npm/dm/@bishopbot/lightweight-charts.svg)](https://www.npmjs.com/package/@bishopbot/lightweight-charts) [![pkg.pr.new](https://pkg.pr.new/badge/bishop-bot/lightweight-charts)](https://pkg.pr.new/~/bishop-bot/lightweight-charts)

> **这是一个叉子。** 它发布在 `@bishopbot` npm范围，而不是作为 `lightweight-charts`。TradingView的上游项目保持不受范围限制 名称和名称 `@tradingview` 范围，并且是要安装的项目，如果您需要 原件。看到 [出版](https://npmcn.com/package/%40bishopbot/lightweight-charts/#readme-publishing) 下面。

[演示](https://www.tradingview.com/lightweight-charts/) | [文档](https://tradingview.github.io/lightweight-charts/) | [Reddit](https://www.reddit.com/r/TradingView/)

TradingView轻量级图表™是最小和最快的金融HTML5图表之一。

轻量级图表™如果您想在网页上显示财务数据作为交互式图表，或者用交互式图表替换静态图像图表，library是您的最佳选择。它不会影响您的网页的加载速度和性能。 库的大小接近于静态图像，但如果你在一个网页上有几十个图像图表，那么使用这个库可以使你的网页的大小更小。

该库提供了一组丰富的图表功能，但您也可以通过构建自定义插件来扩展其功能。浏览 [插件目录](https://tradingview.github.io/lightweight-charts/plugins) 对于现成的插件，或请参阅 [交互式插件示例](https://tradingview.github.io/lightweight-charts/plugin-examples/) 和 [plugin-examples / README.md](https://github.com/bishop-bot/lightweight-charts/tree/master/plugin-examples) 建立你自己的。

看一看 [awesome-tradingview](https://github.com/tradingview/awesome-tradingview?tab=readme-ov-file#lightweight-charts) 我们的社区成员创建的相关项目。

## 安装

### es6通过npm

```bash
npm install @bishopbot/lightweight-charts
```

### 最新的主版本

尝试最新的 `master` 无需等待发布即可构建 (由 [pkg.pr.new](https://pkg.pr.new/)):

```bash
npm install https://pkg.pr.new/@bishopbot/lightweight-charts@master
```

下面的导入和使用适用于两个npm安装选项:

```js
import { createChart, LineSeries } from '@bishopbot/lightweight-charts';

const chart = createChart(document.body, { width: 400, height: 300 });
const lineSeries = chart.addSeries(LineSeries);
lineSeries.setData([
    { time: '2019-04-11', value: 80.01 },
    { time: '2019-04-12', value: 96.63 },
    { time: '2019-04-13', value: 76.64 },
    { time: '2019-04-14', value: 81.89 },
    { time: '2019-04-15', value: 74.43 },
    { time: '2019-04-16', value: 80.01 },
    { time: '2019-04-17', value: 96.63 },
    { time: '2019-04-18', value: 76.64 },
    { time: '2019-04-19', value: 81.89 },
    { time: '2019-04-20', value: 74.43 },
]);
```

### CDN

你可以用 [unpkg](https://unpkg.com/)：

[https://unpkg.com/@bishopbot/lightweight-charts/dist/lightweight-charts.standalone.production.js](https://unpkg.com/@bishopbot/lightweight-charts/dist/lightweight-charts.standalone.production.js)

独立版本创建 `window.LightweightCharts` 对象，并从中导出所有内容 `esm` 版本：

```js
const chart = LightweightCharts.createChart(document.body, { width: 400, height: 300 });
const lineSeries = chart.addSeries(LightweightCharts.LineSeries);
lineSeries.setData([
    { time: '2019-04-11', value: 80.01 },
    { time: '2019-04-12', value: 96.63 },
    { time: '2019-04-13', value: 76.64 },
    { time: '2019-04-14', value: 81.89 },
    { time: '2019-04-15', value: 74.43 },
    { time: '2019-04-16', value: 80.01 },
    { time: '2019-04-17', value: 96.63 },
    { time: '2019-04-18', value: 76.64 },
    { time: '2019-04-19', value: 81.89 },
    { time: '2019-04-20', value: 74.43 },
]);
```

### 构建变体

| 依赖关系包括 | 模式 | ES模块 | IIFE (`window.LightweightCharts`） |
| --- | --- | --- | --- |
| 否 | 产品 | `lightweight-charts.production.mjs` | N/A |
| 否 | DEV | `lightweight-charts.development.mjs` | N/A |
| 是的(独立) | 产品 | `lightweight-charts.standalone.production.mjs` | `lightweight-charts.standalone.production.js` |
| 是的(独立) | DEV | `lightweight-charts.standalone.development.mjs` | `lightweight-charts.standalone.development.js` |

## AI编码助手

此存储库包含两个 [代理技能](https://github.com/bishop-bot/lightweight-charts/tree/master/.github/skills) 用于AI编码助手，例如Claude Code和Codex。这些技能为助手提供了当前的v5知识，而不是从培训中记住的过时片段:

-   [`lightweight-charts`](https://github.com/bishop-bot/lightweight-charts/blob/master/.github/skills/lightweight-charts/SKILL.md) 是关于 _使用_ 图书馆。它涵盖了v5 API约定，心理模型，以及常见的时间，规模，标记，插件和包装脚枪。
-   [`lightweight-charts-plugin-authoring`](https://github.com/bishop-bot/lightweight-charts/blob/master/.github/skills/lightweight-charts-plugin-authoring/SKILL.md) 是关于 _写作_ 一个 [插件](https://tradingview.github.io/lightweight-charts/docs/plugins/intro)。该技能有助于在自定义系列和原始系列之间进行选择，并建立在 `@bishopbot/lwc-toolkit`,并从官方的外套包中学习。它还警告常见的自动缩放，空白和命中测试一下陷阱。这个 `create-lwc-plugin` Wizard提供将此技能安装到一个新的插件项目中。

安装一个或两个 `skills` CLI; 添加 `--skill <name>` 从两个中选择一个：

```console
npx skills add bishop-bot/lightweight-charts
```

## 开发

看到 [建筑.md](https://npmcn.com/package/%40bishopbot/lightweight-charts/BUILDING.md) 有关如何从源代码构建库的说明。

## 出版

此fork的包在 `@bishopbot` 范围:

| 包 | npm名称 |
| --- | --- |
| 图书馆 | `@bishopbot/lightweight-charts` |
| 插件工具 | `@bishopbot/lwc-toolkit` |
| 插件 | `@bishopbot/lwc-plugin-<name>` |
| 插件搭建向导 | `@bishopbot/create-lwc-plugin` |

每个插件中的库的对等依赖关系是 `@bishopbot/lightweight-charts` （`^6.0.0`）; 上游 `lightweight-charts` 保持一个可选的同龄人，所以一个 已经依赖于上游5.X行的项目不必更改 它。看到 [`.agents/skills/npm-publish/SKILL.md`](https://npmcn.com/package/%40bishopbot/lightweight-charts/.agents/skills/npm-publish/SKILL.md) 对于释放流。

## 许可证

根据Apache许可证2.0版（“许可证”）进行许可；除非遵守许可，否则您不得使用本软件。 您可以在 [许可证](https://npmcn.com/package/%40bishopbot/lightweight-charts/LICENSE) 文件。 除非适用法律另有规定或双方书面约定，否则根据本许可证分发的软件按“原样”提供，不附带任何明示或暗示的担保或条件。有关许可证中规定的具体语言、权限及限制，请参阅该许可证。

该软件包含了tslib的几个部分 ([https://github.com/Microsoft/tslib](https://github.com/Microsoft/tslib),(c) 微软公司) 受BSD零条款许可的保护。

此许可要求指定TradingView作为产品创建者。 您应添加通知文件中的 “归属通知” 和指向 [https://www.tradingview.com/](https://www.tradingview.com/) 到您的网站或移动应用程序中可供用户使用的页面。 感谢您创建此产品，如果您将其添加在显眼的位置，我们将不胜感激。 你可以使用 [`attributionLogo`](https://tradingview.github.io/lightweight-charts/docs/api/interfaces/LayoutOptions#attributionLogo) 图表选项，用于显示到的适当链接 [https://www.tradingview.com/](https://www.tradingview.com/) 在图表本身，这将满足链接的要求。

## 常见问题

### @bishopbot/lightweight-charts 是什么？

使用HTML5 canvas构建的高性能财务图表

### 如何安装 @bishopbot/lightweight-charts？

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

### @bishopbot/lightweight-charts 支持 TypeScript 吗？

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

### @bishopbot/lightweight-charts 支持 ESM 还是 CommonJS？

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

### @bishopbot/lightweight-charts 可以商用吗？

@bishopbot/lightweight-charts 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @bishopbot/lightweight-charts 还在维护吗？

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