企业官网建设流程全解析

Ketcher：免费开源的 Web 分子结构编辑器，在浏览器里画分子与反应式

【免费下载链接】ketcherWeb-based molecule sketcher项目地址: https://gitcode.com/gh_mirrors/ke/ketcher

Ketcher 是一个免费开源的 Web 分子结构编辑器。你在浏览器里就能画 2D 小分子、化学反应式，还能画肽链、RNA 这类高分子序列，也可以切到 3D 视图查看立体结构。它适合化学家、实验室科研人员，以及想把化学编辑器嵌进自己 Web 应用的开发者。

项目速览

第一次上手

目标 1：把编辑器跑起来

想达成：在自己的机器上打开一个可用的 Ketcher 画布。

动作：先确认 Node.js 版本不低于 24.14.1、npm 不低于 7（项目 engines 字段的要求），然后克隆并安装：

git clone https://gitcode.com/gh_mirrors/ke/ketcher cd ketcher && npm install

再启动示例项目里的本地开发服务：

cd example npm run dev:standalone

预期看到：终端编译完成，浏览器打开后是一张空白画布，左侧有工具面板，顶部有一排主工具栏按钮。standalone 模式表示计算引擎（Indigo）跑在浏览器里，不需要额外配服务地址。

目标 2：画出第一个苯环

想达成：不翻文档就在画布上放一个常见结构。

动作：按快捷键t。这个键会在苯、环戊二烯、环己烷等常见环模板之间轮换，默认先出苯环。

预期看到：画布上出现一个正六边形，这就是苯的芳香环表示。之后按c、n、o可以直接选碳、氮、氧原子，在画布点击即可放置。

目标 3：把结构保存成文件

想达成：结果能落盘、能分享。

动作：按Mod+s（macOS 上是 Command+s，其他系统是 Ctrl+s）打开保存对话框，选择文件名和格式。

预期看到：对话框里能预览文件内容、选择 MOL、SMILES、InChI、KET 等格式，还能一键复制。详细格式清单见 官方帮助文档 的 Working with Files 一节。

按任务走一遍功能

画分子：从周期表里挑元素

工具栏只放了 C、N、O 这几个高频原子，其余元素不用记。

点左侧的 PT 按钮打开周期表窗口，支持按单元素、元素列表等模式选择。选好后在画布点击放置原子，再用键工具连接，支持单键、双键、三键和芳香键。原子价不对时会用红色下划线标出来，方便你立刻发现错画。

检查立体结构：切到 3D 视图看一眼

平面图画完，往往想确认手性中心和空间取向对不对。

点顶部工具栏的 3D Viewer 按钮，结构会以模态窗口弹出。按住鼠标左键旋转，滚轮缩放。默认的渲染方式是线条 + 亮色原子着色，可以在 Settings 的 3D Viewer 标签里调整外观和背景。

导入已有结构，再导出给同事

结构来源不只靠手画。

Open 菜单提供三个入口：从剪贴板粘贴内容、从文件打开、作为新项目打开。选中文件后，内容会先预览再决定是否加入画布。分子模式支持 MOL、SDF、SMILES、扩展 SMILES、InChI、CML、CDX 等常见格式；高分子模式还支持 FASTA、HELM 等生物序列格式。

画一条肽链：切到高分子模式

研究蛋白质或核酸时，画单个氨基酸效率太低。

点工具栏上的 Molecules/Macromolecules 切换器进入高分子模式（当前模式旁边有对勾）。左侧库里有标准氨基酸、核苷酸等预设单体，点选后拖到画布即可拼接成链；也可以切到序列模式，直接按字母输入序列再回来微调。

踩坑提示

• 现象：手画的结构键长不齐、摆位凌乱。解法：点顶部工具栏的 Layout 按钮（Mod+l）自动排版，或用 Clean Up（Mod+Shift+l）统一键长、角度和空间排布。两者都是让结构"变好看"的标准操作，投稿前建议都跑一遍。

• 现象：自动排版、CIP 计算、结构检查这类按钮点了没反应或报错。解法：这些功能依赖底层的 Indigo 计算引擎。示例默认用 standalone 模式（引擎跑在浏览器里），如果你按 remote 模式集成到自己的项目，需要正确配置服务地址，具体变量和默认值写在 DEVNOTES.md 里。

• 现象：npm install 时报 node 版本不满足。解法：项目要求 Node >= 24.14.1 且 npm >= 7。用node -v检查，版本不对就切换，别强行降级 npm 依赖。

• 现象：画布上有反应箭头，导出 MOL 时报错。解法：含箭头的画布要按反应导出（RXN 格式），纯结构才走 MOL 导出，这是刻意的区分而不是故障。另外保存分子时如果结构有问题，对话框会出现 Warnings 标签页，点进去能看到具体告警，改完再存更干净。

收尾

建议先照着 官方帮助文档 画一个苯环并保存成 mol 文件，再切到高分子模式画一条四氨基酸的肽链，把两种模式各摸一遍。之后如果想把它嵌进自己的应用，直接看 example/ 下的集成示例，它演示了 Editor 组件的标准用法。

【免费下载链接】ketcherWeb-based molecule sketcher项目地址: https://gitcode.com/gh_mirrors/ke/ketcher