Cytoscape 官网下载 – 网络图分析入门与版本辨析

先给结论：官网只有一个，产品却有三个

Cytoscape 的官方网站是 cytoscape.org，它是一个开源软件平台，用来把复杂网络数据可视化，并把网络与各种属性数据整合在一起分析。桌面版采用 Java 编写、以 LGPL 协议开源，个人与研究用途免费，无需注册账号即可下载。当前官网下载页标注的版本为 3.10 系列，安装包会自动为你装好 Adoptium 的 OpenJDK Java 17 运行环境，Windows 与 macOS 用户不必自己先配 Java。

搜这个词的人最容易踩的坑，是把三个同名产品当成一个。Cytoscape Desktop 是装在电脑上的桌面软件；Cytoscape.js 是给网页前端用的 JavaScript 图形库，要在代码里调用；Cytoscape Web 是浏览器里用的轻量版本。三者界面、用途、安装方式完全不同，下载前先想清楚自己要的是哪一种。

还要提前说清一个概念差异：Cytoscape 做的是”网络图”——节点和边构成的拓扑关系图，不是流程图、组织架构图那种带方向的业务流程。如果你要画的是流程图，用错工具会白折腾一场。

下载与平台对照表

下载时的两个细节值得留意。第一，Windows 压缩包用系统自带的解压功能解不开，官网明确建议用 7-Zip 或 WinZip 这类第三方工具，硬解会报错。第二，macOS 分 Apple 芯片与 Intel 芯片两个安装包，下错版本能装上但启动会异常，看清自己机器的处理器类型再点。

四个区域与第一张图的画法

打开桌面版，界面可以分成四块来理解：左上方的网络画布是主工作区；左下是属性浏览器，节点的颜色、大小、标签都靠它调；右侧是表格面板，节点表和边表各一张，数据在这里进出；顶部是菜单与工具栏，布局算法、样式、App 都从菜单进入。

画第一张图的流程并不复杂，按五步走：

第一步，准备数据。最省事的方式是两张表：节点表包含 id 与名称等列，边表包含 source 与 target 两列。用 Excel 整理好后存成 CSV 或 TSV，导入时指定哪一列是源节点、哪一列是目标节点，Cytoscape 会自动建网。

第二步，导入。菜单里选择从文件导入网络，选中边表；如果同时有节点属性表，再导入一次并选择按 id 合并。导入后画布上会出现一团乱麻，这是正常现象，因为还没做布局。

第三步，选布局。菜单里的布局选项提供力导向、圆形、分层、网格等多种算法。关系网一般先用力导向，看整体聚类；层级明确的网络用分层布局；节点少的时候圆形布局更清爽。布局不满意就换一个重跑，随时可逆。

第四步，调样式。在样式面板里把节点标签映射到名称列，节点大小映射到度值或某个数值列，边的粗细映射到权重列。这一步是让图”能说话”的关键：一张全是同色同大小圆点的图，读者看不出任何信息。

第五步，导出。可以导出为图片用于报告，也可以导出为网络文件保存下来，方便下次接着改。要发表用的图，建议调高导出分辨率，比截图清晰得多。

数据怎么进来：格式与字段

Cytoscape 支持的网络格式不少，常用的有几类：纯文本的边列表、SIF 格式、GraphML、XGMML，以及从 CSV 表格直接构建。选择哪种取决于数据来源——从数据库或脚本导出的，多半是 CSV；从其他网络工具转过来的，常见 GraphML。

字段设计上有一个经验：节点 id 用什么，全流程就要统一。有人用基因名做 id，有人用编号，中途换一次就会对不上，属性合并失败往往就是这个原因。建议 id 用稳定不变的编号，名称单独放一列做显示标签。

属性数据是 Cytoscape 真正的价值所在。把表达量、分组、置信度这些数值列导进来之后，才能做颜色映射、大小映射、筛选与统计。只导入节点和边、不导入属性，等于只用了这个软件的三成功能。

App 生态：插件补足专业分析

桌面版的功能通过 App 扩展，菜单里的 App Manager 可以直接浏览和安装。社区贡献的 App 超过百个，覆盖不同领域。对一般使用者来说，值得先了解的是三类：

第一类是网络统计类，比如计算度、介数、聚类系数等指标，把拓扑特征量化出来。第二类是聚类与模块识别类，用来从大网络里找出紧密的子群。第三类是特定领域的数据库连接类，可以直接读取公开的路径或互作数据。

装 App 时注意两点：一是版本兼容，不同 Cytoscape 版本支持的 App 范围不同，装了不兼容的会启动失败；二是来源，优先从 App Manager 内安装，官网登记的 App 才有更新保障。

如果需要把分析流程自动化，桌面版提供了 cyREST 接口，配套 py4cytoscape（Python）与 RCy3（R）两个库，可以从脚本里调用。做批量分析、需要可重复的研究流程时，这条路比手工点菜单可靠得多。

与同类工具的适用场景对照

选工具前先看场景，比看功能列表更有用：

这张表的用法是倒着看：先确认自己的数据有没有结构（节点、边、属性），有结构才轮到网络分析工具；没有结构、只是想把几个框连起来，通用绘图工具更快。

出图与存档：让图在文档里看得清

把图做出来只是第一步，能不能放进报告被人看懂是另一回事。三条经验值得记下。

第一条是控制节点数量。一张塞进A4纸宽度的图，节点超过一百个就很难分辨标签。宁可先筛出核心子网，把全量网络另存一份作为附录，也不要指望读者在密密麻麻的点阵里找信息。

第二条是标签与颜色的取舍。标签全开必然重叠，常用做法是只给关键节点显示标签，其余节点靠悬停或图例说明；颜色映射要有图例，同一张图里不要用超过五六种分类色，人眼分辨不了那么多。

第三条是存档格式。导出图片方便插入文档，但要接着改就必须保存网络文件：边表、节点表和样式都在里面，下次打开能原样恢复。只留图片的话，等于把工作成果压缩成了一张不能编辑的平面文件。

投稿或汇报时还有一个细节：导出的图片分辨率要够。默认导出的位图在屏幕上看着没问题，印出来就发虚。输出时把分辨率调高，或者直接导出矢量格式，缩放不失真。

常见问题

1. Cytoscape 是免费的吗？ 桌面版是开源软件，按 LGPL 协议发布，免费使用。官网下载不需要填表、不需要注册账号。用于论文时，官网给出了应当引用的原始文献，按要求引用即可。

2. 安装后打不开或一直停在启动画面怎么办？ 多数是 Java 环境的问题。安装包本应自动配置 OpenJDK 17，如果系统里原有其他版本的 Java 且环境变量指向它，就可能冲突。可以先卸载旧版 Java 再重装，或按官网指引手动指定 JDK。

3. 导入 CSV 后画布上什么都没有？ 先检查两件事：导入时是否正确指定了源节点列与目标节点列；文件编码是否为 UTF-8。中文列名在某些编码下会读成乱码，导致列识别失败，另存为 UTF-8 再试。

4. 节点太多，图糊成一团怎么处理？ 不要硬调布局参数解决。先做筛选：按度值或某个指标过滤掉低权重节点，把网络缩到几百个节点以内再看；需要展示全貌时，用聚类先合并成模块，再逐层展开。

5. 桌面版和 Cytoscape.js 可以互相导数据吗？ 可以，网络文件格式基本通用，桌面版导出的网络文件可以被网页端读取。但两边的样式定义机制不同，桌面版调好的视觉样式不会原样带到网页里，网页端的样式要在代码中重新配置。

避坑：三个容易浪费时间的误区

第一个误区是去第三方下载站找安装包。Cytoscape 官网直接提供各平台安装包，不需要经过任何下载站。第三方打包的版本可能被捆绑其他软件，也可能因为缺少自动配置 Java 的步骤而装不上。

第二个误区是把它当绘图软件用。Cytoscape 没有自由拖拽画框的功能，所有图形都建立在数据模型上。想画一张概念示意图，用通用绘图工具十分钟能完成的事，在这里可能要建两张表。

第三个误区是忽略版本与 App 的匹配。升级桌面版之后，原先装的 App 可能不再兼容，表现为启动卡住或功能消失。升级前先记下正在用的 App 列表，升级后逐个确认，比事后排查省事。