2. 3D Slicer安装与工程环境搭建

3D Slicer 是一个跨平台的开源医学影像处理与可视化平台，其安装过程本身并不复杂，但真正决定后续工作效率的，是安装完成之后的工程环境搭建。很多初学者在“能打开软件”这一步就停下了，结果在加载 DICOM、安装扩展、运行 Python 脚本时反复踩坑。本节把安装与环境搭建作为一个整体任务来处理：先让软件在 Windows、macOS、Linux 上正确运行，再让扩展、Python、DICOM 数据库和工程目录形成一套可复用、可版本管理的工作环境。

一、三平台安装要点

3D Slicer 官方为三个平台提供预编译安装包，版本号通常以稳定版（如 5.6.x）和预览版（Preview）区分。稳定版适合临床科研与教学，预览版包含最新功能但可能存在回归问题。安装时建议遵循以下原则：

• Windows：下载 .exe 安装包，安装路径避免中文和空格，例如使用 D:\Slicer\5.6.2。安装完成后首次启动会提示选择扩展目录和临时目录，建议都放在非系统盘。
• macOS：下载 .dmg，将 Slicer 拖入 Applications。首次打开若提示“无法验证开发者”，在“系统设置 → 隐私与安全性”中允许即可。Apple Silicon 与 Intel 版本要对应芯片类型。
• Linux：官方提供 .tar.gz 包，解压后直接运行 ./Slicer。若缺少依赖，可用 ldd 检查缺失库；也可通过包管理器安装，但版本往往滞后，不推荐用于工程环境。

安装完成后，建议在“Edit → Application Settings”中确认三项：Modules 路径、Extensions 路径、Python 解释器路径。这三项决定了后续扩展和脚本能否被正确加载。

二、扩展管理器与 Python 环境

3D Slicer 的扩展通过 Extension Manager 安装，它本质上是从官方扩展服务器下载与当前版本匹配的二进制包。常用扩展包括 SlicerRT（放疗）、SlicerElastix（配准）、SegmentEditorExtraEffects（分割增强）、DCMQI（DICOM 量化）。安装扩展时要注意：扩展与 Slicer 主版本严格绑定，升级主程序后需要重新安装扩展。

Slicer 内置 Python 解释器，但它的环境是独立的，不能直接使用系统 Python 的 pip 安装包。正确做法是使用 Slicer 自带的 PythonSlicer 或 slicer.util.pip_install()。例如在 Python Console 中执行：

import slicer
slicer.util.pip_install("pydicom")
slicer.util.pip_install("numpy")

这样安装的包会进入 Slicer 的 site-packages，重启后仍可用。若需要固定环境，可在工程目录下建立 requirements.txt，并在启动脚本中批量安装，保证不同机器上环境一致。

三、DICOM 数据库配置

DICOM 数据库是 Slicer 管理影像数据的核心。默认情况下，Slicer 使用内置的 SQLite 数据库，路径在用户目录下。对于工程项目，建议显式配置数据库位置，避免数据散落。操作路径为：DICOM → Database → 选择数据库目录，然后点击 Import DICOM files 导入。

导入后，Slicer 会建立索引，可在 DICOM Browser 中按 Patient、Study、Series 三级浏览。一个常见问题是导入后看不到图像，通常是因为缺少 DICOMDIR 或文件不完整。此时可勾选 Copy files 和 Import，让 Slicer 把原始文件复制到数据库目录并重建索引。对于多模态研究，建议按 PatientID/StudyDate/SeriesDescription 组织，便于后续批量处理。

四、工程目录规范与版本管理

一个可复用的 Slicer 工程目录，应当把数据、脚本、配置和文档分开。推荐结构如下：

project_root/
├── data/
│   ├── dicom/          # 原始 DICOM
│   ├── nifti/          # 转换后的 NIfTI
│   └── seg/            # 分割结果
├── scripts/
│   ├── load_data.py
│   ├── preprocess.py
│   └── export_seg.py
├── config/
│   ├── requirements.txt
│   └── slicer_settings.ini
├── docs/
│   └── README.md
└── .gitignore

版本管理方面，DICOM 和 NIfTI 文件体积大，不建议直接提交到 Git。应在 .gitignore 中排除 data/，只跟踪脚本、配置和文档。若必须共享数据，可使用 Git LFS 或外部存储。脚本中应避免硬编码绝对路径，改用相对路径或环境变量，例如：

import os
DATA_DIR = os.environ.get("SLICER_PROJECT", ".")
dicom_dir = os.path.join(DATA_DIR, "data", "dicom")

这样在不同机器上只需设置一次环境变量，工程即可迁移。

五、环境验证与常见问题

环境搭建完成后，建议做一次最小验证：新建一个 Python 脚本，加载一个 NIfTI 文件并输出其尺寸和原点。若能在 Python Console 中正确打印，说明 Python 环境和数据路径都正常。常见问题包括：扩展安装后未重启导致模块不显示；DICOM 导入后 Series 为空，通常是文件不完整或缺少必要标签；Python 包安装后 import 失败，多半是装到了系统 Python 而非 Slicer 内置解释器。

总体来看，3D Slicer 的安装只是入口，真正的工程环境由“平台安装 + 扩展 + Python + DICOM 数据库 + 目录规范 + 版本管理”共同构成。把这六件事一次做对，后续的影像加载、分割、配准和批量处理才能稳定推进。