# @deephaven/code-studio 中文文档

规范地址：https://npmcn.com/package/%40deephaven/code-studio/

版本：1\.33\.2
npm 元数据更新时间：2026-11-12T14:49:07.089Z
中文译文更新时间：2026-11-12T14:50:13.484Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40deephaven/code-studio
原文对照：https://npmcn.com/package/%40deephaven/code-studio/?lang=original
项目主页：http://./
源码仓库：https://github.com/deephaven/web-client-ui

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

- 包体积（解压后）：71.9 MB，408 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：48 个
- 首次发布：2021-04-29T13:07:37.665Z
- 最新版本发布：2026-11-12T14:49:06.637Z
- 近 30 天下载量：8450（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：1165（近 12 个月 80 个）

## 中文简介

深源代码工作室

## 安装

```sh
npm install @deephaven/code-studio
```

也可以使用：`pnpm add @deephaven/code-studio`、`yarn add @deephaven/code-studio`、`bun add @deephaven/code-studio`

## README

# 导言

代码工作室是一个连接运行的网络应用程序 [深黑龙骨](https://github.com/deephaven/deephaven-core/) 举个例子 你可以很快提起一个 [来自预建图像的深端后端](https://deephaven.io/core/docs/getting-started/quickstart/#1-install-and-launch-deephaven)。一些注释可以让开发人员快速上线和运行.

## 运行

要启动代码工作室,运行 `npm install` 财务报告和审定财务报表 `npm start` 在此寄存器的根目录中。 见 [开始](https://npmcn.com/package/README.md#getting-started) 详细情况.

## 工程设置

工程特定设置存储于 `.env` 文档。 还有一个 `.env.development` 仅是文件 装入开发的建筑物,以及 `.env.development.local` 仅供当地建筑使用。 为了地方发展, 您应该修改 `.env.development.local`。 。 。 . 详情 `.env`,参见 [虚拟文件](https://vitejs.dev/guide/env-and-mode.html)。 。 。 . 下面是一些可配置于 `.env` 文档.

### 维泰 CORE API URL

一个常见的设置是将API服务器URL覆盖到另一个服务器. 例如,在 `.env.development.local` 拥有 `npm start` 指向 API 的远程服务器 :

```shell
VITE_CORE_API_URL=https://www.myserver.com/jsapi
```

### VITE LOG 级别

调试时打印详细日志可以方便. 您已经设定了最高的伐木水平 `.env.development` 文档。 你可以改变它英寸 `.env.development.local` 如果需要的话.

```shell
VITE_LOG_LEVEL=2 # Warn/Error
```

见 [@ diephaven/ log (帮助)](https://npmcn.com/package/%40deephaven/log) 关于日志的更多细节.

### 维特 ENABLE LOG PROXY

设定为 `true` 或者说 `false`

打开记录器代理, 它可以捕捉日志消息, 这样用户就可以轻易为我们导出调试信息 。 启用此选项将影响控制台显示的行号 。 在发展中默认为虚假,在生产中则属实.

在发展中, `DHLogProxy` 财务报告和审定财务报表 `DHLogHistory` 被添加到窗口中,以便在必要时可以从控制台直接操纵它们. `DHLogProxy.enable()` 将捕获和释放所有伐木活动的事件. `DHLogHistory.enable()` 将事件听众附加到 `DHLogProxy` 事件。 都有一个 `disable` 方法.

## 数据存储

有当前会话的数据被存储在本地redux状态(Redux Data)中,在会话之间坚持的数据被存储在浏览器存储中.

### Redux 数据

应用程序使用 Redux 本地存储当前会话的数据 。 看一看这里 `src/redux/reducers/index.js` 用于对一般结构和存储内容进行注释的文档,并进入单个压缩器获取存储数据的细节.

您也可以使用 Chrome Redux DevTools 来检查在开发或生产环境中的活性: [https://chrome.google.com/webstore/detaile/redux-devtools/lmhkpmbekcpmknklioeibfkpmmfibljd?hl=en 互联网档案馆的存檔,存档日期2013-12-22](https://chrome.google.com/webstore/detail/redux-devtools/lmhkpmbekcpmknklioeibfkpmmfibljd?hl=en)

状态过渡也在开发构建中的浏览器开发者控制台中被登录.

### 工作空间数据

工作空间数据被存储在浏览器localStorage中. 见 [本地工作空间集](https://npmcn.com/package/%40deephaven/code-studio/src/dashboard/LocalWorkspaceStorage.ts) 详细执行情况.

## 模拟 API

在开发过程中,您可能想要测试一些可能繁琐的特定案例,以测试真实的堆栈. 您可以在 `public/__mocks__/dh-core.js` 执行 `npm run mock` 命令。 这个模型也用于单位测试. 当将新功能添加到API中时,最好在模拟API中再添加一个普通成功案例的分块,以避免在运行模拟时断裂.

## 样式指南/组件开发

在开发模式下运行时( W)`npm run start`http://localhost:4000/ide/styleguide上提供样式指南。 样式指南可用于开发组件. 风格导引显示许多共同的组件以及如何使用. 创建新组件时,应添加到 [样式指南](https://npmcn.com/package/%40deephaven/code-studio/src/styleguide/)。注意样式导引器懒惰地装入 [应用程序](https://npmcn.com/package/%40deephaven/code-studio/packages/code-studio/src/main/AppRouter.tsx),因此不应增加主应用程序捆绑大小.

## 建筑

关于使用的套接字和端口的更详细情况,见 [网络服务](https://docs.deephaven.io/latest/Content/runbook/OpsGuide.htm?Highlight=socket%20ports#Network_Services) 财务报告和审定财务报表 [网络 API](https://docs.deephaven.io/latest/Content/systemAdmin/sec_webAPI.htm) 我们的文件.

### 盘子

该应用的主要布局基于 [盘子](https://npmcn.com/package/%40deephaven/code-studio/src/dashboard/DashboardContainer.jsx),这基本上是用户打开的顶级标签。 在装入Dashboard之前,它只是 [懒达什板](https://npmcn.com/package/%40deephaven/code-studio/src/dashboard/LazyDashboardContainer.jsx)。一旦启动,它就会将布局加载到金色布局中。 其布局由众多的面板组成(见下文). 每个Dashboard容器都听 [标签事件](https://npmcn.com/package/%40deephaven/code-studio/src/main/tabs/TabEvent.js) 高级应用软件, 和在 [金色布局事件Hub](https://golden-layout.com/tutorials/getting-started-react.html)。 。 。 .

### 小组讨论会

每个板由面板组成. 有许多不同的面板,例如: [IrisGrid小组](https://npmcn.com/package/%40deephaven/code-studio/src/iris-grid/IrisGridPanel), (中文(简体) ), [图表板](https://npmcn.com/package/%40deephaven/code-studio/src/chart/ChartPanel.jsx), (中文(简体) ), [标记下方格](https://npmcn.com/package/%40deephaven/code-studio/src/controls/markdown/MarkdownPanel.jsx),以及 [控制台板](https://npmcn.com/package/%40deephaven/code-studio/src/console/ConsolePanel.jsx)。每个面板应保存一个可以序列化并保存在数据库中的去水分状态,然后在打开仪表板时被去序列化并被水分. 脱水/水分步骤的定义如下: [板板容器](https://npmcn.com/package/%40deephaven/code-studio/src/dashboard/DashboardContainer.jsx) 与 `makeHydrateComponentPropsMap` 财务报告和审定财务报表 `dehydrateClosedComponentConfigMap`。 。 。 .

# 初始工程设置

这个项目使用 [维特](https://vitejs.dev/)。 。 。 .

## 学习更多

你可以多学点 [虚拟文档](https://vitejs.dev/guide/)。 。 。 .

学回放,看看 [反应文档](https://reactjs.org/)。 。 。 .

# 法律通知

深黑文数据实验室和任何撰稿者都根据Apache 2.0 许可证向您颁发了此寄存器内容的许可证,请参见 [自由主义](https://npmcn.com/package/LICENSE) 文档.

## 常见问题

### @deephaven/code-studio 是什么？

深源代码工作室

### 如何安装 @deephaven/code-studio？

在项目目录运行 npm install @deephaven/code-studio，或使用 pnpm add / yarn add / bun add。

### @deephaven/code-studio 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/deephaven\_\_code-studio 是否存在。

### @deephaven/code-studio 支持 ESM 还是 CommonJS？

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

### @deephaven/code-studio 可以商用吗？

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

### @deephaven/code-studio 的下载量有多少？

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

### @deephaven/code-studio 还在维护吗？

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