Weasis：内建 2D/3D 影像分析的开源 DICOM 查看器

Weasis：内建 2D/3D 影像分析的开源 DICOM 查看器

【免费下载链接】WeasisWeasis is a web-based DICOM viewer for advanced medical imaging and seamless PACS integration.项目地址: https://gitcode.com/gh_mirrors/we/Weasis

Weasis 是一款开源 DICOM 查看器，可在 Windows、macOS、Linux 桌面端运行，本地打开 CT/MR 等影像序列，通过 DICOMweb 接入 PACS，并输出测量结果与 3D 重建。适合影像科人员、影像研究者以及需要二次开发的工程师。

项目速览

DICOM 查看器常承担的三件事

读取并测量一个 CT 序列

你想快速翻完一位患者的全部层面、标记病灶并拿到大小与 CT 值。左侧 DICOM Explorer 选中序列后，中间区域可同时铺排轴位、冠状位、矢状位与 3D 容积渲染视图；需要斜位平面时走 Oblique MPR 菜单，支持机架倾角校正与曲面重建。右侧测量工具覆盖长度、面积、角度（含 Cobb 角）、自由形区域与区域统计（Min、Max、Mean、StDev 等），结果直接标在图上，完成后以 DICOM Presentation States 或 XML 导出。

接入院内 PACS

你想不先把数据从 PACS 里导出来、就在查看器里打开远程检查。两条路：客户端直接配置 DICOM 节点与 DICOMweb 源（QIDO-RS / WADO-RS / STOW-RS，走 HTTPS）；或经 ViewerHub 这类网关在服务器端代理，查看器只连一个端点。经典 DIMSE（C-FIND、C-GET、C-MOVE）与 C-STORE 发送同样支持，登录方式覆盖 Basic、OAuth 2.0 与 OpenID Connect。医生在 EHR/RIS 里点一下患者记录，weasis:// 协议就能把对应检查拉进查看器。

把普通媒体转成 DICOM

你想让图片、视频或 STL 模型以标准 DICOM 形态进入影像流水线。Dicomizer 模块（weasis-acquire/）导入非 DICOM 媒体后按模态预设转换成 DICOM 文件，并校验视频尺寸。转完后这些媒体可以 C-STORE 存入 PACS，也可以刻成内嵌查看器的 DICOM 光盘。

把这款 DICOM 查看器跑起来

1. 克隆仓库并进入目录：

git clone https://gitcode.com/gh_mirrors/we/Weasis cd Weasis

2. 安装 JDK 25+ 与 Maven 3.8.1+（CI 使用 JDK 26 Temurin）。
3. 构建（跳过测试）：

mvn -B -ntp install -DskipTests

4. 若要打原生安装包：先mvn -B clean install，再mvn -B -P compressXZ -f weasis-distributions clean package，最后运行 weasis-distributions/script/package-weasis.sh 驱动 jpackage 生成安装包，跨平台细节见 Native-Build-Overview.md。
5. 运行安装包启动，把第一个 DICOM 文件夹拖进去。

如果只想先试用，官网提供三大平台的二进制安装包与在线演示，无需构建。

第一次运行的常见卡点

• 构建立刻报 JDK 版本错误：weasis-parent/pom.xml 里的 maven-enforcer-plugin 强制 JDK 25+，低版本 JDK 会直接失败，先换 JDK。
• OpenCV 相关测试在 IDE 里跑不过：Surefire 会注入-Djava.library.path=target/lib/<os>-<arch>定位原生库，必须通过 Maven 运行测试。
• spotless:check 报缺头或格式问题：提交前先执行mvn spotless:apply，它负责补 EPL/Apache 双许可头并套用 Google Java Format。

进阶选读

用 archetype 生成插件骨架

archetype/ 内置 weasis-plugin-base-viewer 与 weasis-plugin-dicom-viewer 两个模板：在该目录执行mvn install，再运行mvn archetype:generate -DarchetypeCatalog=local即可得到能挂进 Weasis 的插件工程。插件 SDK 的接口位于 weasis-core 的org.weasis.core.api.*包下，查看器基类如DefaultView2d、SynchView都在其中。

大数据的内存调优

大序列加载的内存管理机制见 weasis-core/docs/Memory-Management.md，MemoryManager与ResourceAdvisor位于org.weasis.core.util；堆不足时把 JVM 参数提到-Xmx4096m再观察缓存行为。

常见问题

问：部分压缩 DICOM 打不开，是不是 Weasis 不支持该格式？答：JPEG（基线/扩展/无损）、JPEG-LS、JPEG 2000、JPEG-XL、RLE 等常见压缩传输语法都支持。仍打不开时，先在 DICOM 属性面板里查该文件的 Transfer Syntax（面板支持检索全部属性）。

问：在 Mac M1 上能用吗？答：可以。weasis-opencv 与 JOGL 的原生包按平台拆分，其中 macosx-aarch64 对应 Apple Silicon；官方 macOS PKG 安装包含公证。

问：没有部署网关也能连 PACS 吗？答：能。客户端直接配置 DICOM 节点与 DICOMweb 源，每个源单独设置 QIDO/WADO/STOW；也可以反过来用 ViewerHub 网关在服务端代理 PACS 访问。

下一步

git clone https://gitcode.com/gh_mirrors/we/Weasis，按上文构建并打开第一个 DICOM 文件夹。注意它是查看器而非 PACS 服务器，影像存储与治疗规划不在它的范围内。

【免费下载链接】WeasisWeasis is a web-based DICOM viewer for advanced medical imaging and seamless PACS integration.项目地址: https://gitcode.com/gh_mirrors/we/Weasis