企业官网建设流程全解析

简介：CAT12.7版本安装包面向使用SPM/CAT工具箱进行脑结构T1像分析与建模的研究人群，为神经影像入门者、医学生以及需要复现脑图处理流程的算法人员提供稳定可用的经典运行环境。作者笔记即按该版本整理，针对官方更新后旧版本难以获取的问题，特意上传这套自用包，方便读者对照学习VBM与表面形态测量时的参数设置和函数依赖。压缩包约222.93MB，共822个文件，主体为MATLAB脚本与编译好的mex函数，同时包含Schaefer、HCP-MMP等脑图谱分区标注、表面网格处理函数、nii示例模板以及说明文档，exe/sh等辅助文件可用于环境校验或批处理调用。目前已有1727人学习浏览，适合需要固定版本延续课题、减少反复调试兼容性问题的科研用户，也可作为课堂教学演示和后续二次开发的起点。

1. 下载 CAT12.7 之前，先把版本账算清楚

很多接触神经影像分析的同学，第一次装 CAT12 都是从“找个安装包、解压、加进 MATLAB 路径”开始的。但 CAT12.7 这个版本恰恰是“解压即用”最容易翻车的一版：它同时依赖 MATLAB 版本、SPM12 版本，以及系统里能不能找到匹配的编译器。我遇到过某位同行在共享工作站上装了一整天，启动时报错到连 MATLAB 主界面都弹不出来，最后翻日志才发现是 MATLAB 的 Java 版本和 CAT12.7 的图形模块冲突。

这类工具不是装上就行，装完必须能跑批处理、能出 VBM 统计结果。给正在卡在“CAT12.7 安装包哪里下、装完怎么配”的开发者一条实际可走的路线：先选对版本组合，再按批处理场景配置，最后用示例数据跑通验证。适合要在 MATLAB 环境下做体素形态学分析、需要稳定复现预处理流程的人。本文按我实际部署过的配置路径写，每一步都能直接照着敲。那些只告诉你“解压到路径就能用”的教程，默认省略的恰恰是最容易踩坑的环节。

2. 装之前先理清三件事：MATLAB、SPM12 与 CAT12.7 的版本对应

2.1 版本对应表与选型建议

CAT12.7 并不是一个独立运行的软件，它本质上是 SPM12 框架下的一个工具包，大量底层函数直接调用 SPM12 的路径管理与批处理引擎。也就是说，你的 MATLAB 里必须先有一套能正常工作的 SPM12，再在这个基础上叠加 CAT12.7，顺序反了或者版本差了，启动时都会报“找不到函数”或“参数文件不存在”。

我一般建议按以下组合做部署，这套组合在 Windows 和 Linux 上都验证过，兼容性比较稳：

如果你的 MATLAB 版本过低，我不建议硬上 CAT12.7。曾经在 R2016b 上强行跑新版 CAT12，结果在分割阶段 MEX 文件直接崩溃，连错误信息都不完整。看日志才知道，CAT12.7 在初始化时调用了 R2018a 之后才有的底层接口，这个不是改几行代码能绕过的，“升级 MATLAB”是最省事的解法。另外，如果实验室有多台机器，尽量保持 MATLAB 版本一致，否则批处理脚本在两台机器上跑出来的结果会因数值库差异产生细微偏差。

这里要补充一句：选用版本组合时，不要只看 CAT12.7 发布说明里写的“最低要求”，要把“驱动显卡、MATLAB 的 Java 运行时、系统编码”也当成隐式依赖一并检查。

2.2 下载什么：预编译包、源码包与完整性校验

作为“源码软件”，CAT12 的分发形式通常有两种：一是官方编译好的预编译包，解压即用；二是提供源码压缩包，需要在自己的 MATLAB 环境里重新编译 MEX 文件。对绝大多数使用者，我强烈建议选预编译包，除非你需要在非常规 CPU 架构上运行。

同类的“源码软件”都有这个特点：源码包的好处是透明、可修改，但代价是你必须自己搞定编译器、MATLAB SDK、MEX 配置三个环节，任何一个不匹配都会让安装时间翻倍。预编译包则把这三个环节全部跳过，代价是平台固定。所以请在下载页面里认准你的操作系统版本，Windows 的包不要拿到 Linux 上用，即使文件名都是.zip，里面的 MEX 文件后缀和编译参数完全不同。

下载完成后，先做完整性校验，这一步很多人省略，但解压到一半才报“文件损坏”时后悔药就没了。Linux 或 macOS 下在终端里执行：

md5sum CAT12.7_xxx.zip

输出示例： a3f2b8c1d4e5f6a7b8c9d0e1f2a3b4c5 CAT12.7_xxx.zip

再到官方发布页比对 MD5 值，一致再解压。Windows 下可以用 PowerShell 执行Get-FileHash。这一步能过滤掉绝大多数下载不完整的问题。我遇到的“解压时报错”案件里，约四成是下载过程丢包，尤其是用下载工具多线程拉取时最容易出现。

2.3 运行环境自检：内存、Java 与编译器

CAT12.7 做 VBM 预处理时，单例 T1 数据的峰值内存通常在 4GB 到 8GB 之间，如果同时开并行池处理多例数据，16GB 内存的机器很容易触顶。建议在安装前用系统监控确认一下可用内存，不要等批处理跑到一半被 OOM killer 中断。MATLAB 本身默认的 Java 堆内存可能不够，尤其是显示图像和打开 CAT12 图形界面时。可以在 MATLAB 命令行里执行：

java.lang.Runtime.getRuntime.maxMemory / 1024 / 1024

ans = 1.5243e+03

单位是 MB，这个值是我在 8GB 内存机器上测到的默认值。如果你执行批处理时频繁出现 Java 堆溢出或者 MATLAB 界面直接灰掉，可以在 MATLAB 启动参数里增大堆内存。常见做法是在启动命令里加-J-Xmx4g：

matlab -desktop -J-Xmx4g

参数说明：-J表示把后面的参数传给 Java 虚拟机，-Xmx4g指定最大堆为 4GB。这个参数不解决所有问题，但能显著减少 CAT12 图形交互时的崩溃概率。如果跑的是纯命令行的独立版本，可以不启动 Java 虚拟机，直接加-nojvm，能省出一部分内存给计算本身。编译器这一项在解压预编译包时其实已经用不到了，只有当你打算从源码重新编译时才需要准备。但建议把编译器的匹配版本记下来，至少你是知道它是为哪个 MATLAB 版本编译的，这能减少后续排查“MEX 文件版本不兼容”时的猜测成本。

3. 安装与路径配置：目录规划、startup.m 与 set path 的取舍

3.1 目录结构规划与权限准备

CAT12 的安装过程本身不复杂，复杂的是目录选不好、权限不够、路径写错这“三件套”引发的后续问题。我这里给出的目录结构是经过多次迁移后固定下来的习惯，兼顾多版本并存和备份迁移：

/opt/neuro_tools/ ├── spm12/ ├── cat12/ └── data/

/opt 需要 root 权限，普通开发机可以换成 $HOME/neuro_tools/

我一般会把 SPM12 和 CAT12 放在同一个父目录下，而不是各自散落在下载文件夹里。原因是 CAT12 识别 SPM12 路径时，有时会默认按相对关系查找，如果两个目录隔得太远，批处理时可能出现“找不到 SPM12 的 defaults 文件”。同时，避免使用带空格或中文的路径。CAT12 的底层脚本对路径中的空格处理并不完善，虽然大多数时候能跑，但一旦报错，排查成本极高，不值得赌。我自己就见过数据路径里一个中文文件夹名导致分割结果里所有文件名乱码的案例。

权限方面，如果 MATLAB 是以普通用户身份运行，务必保证上面三个目录对当前用户可读写。常见错误是安装时用sudo解压到/opt，之后用普通用户启动 MATLAB，就会出现“能打开界面但无法写入工作目录”的怪问题。处理方式是在安装完成后统一修改属主：

sudo chown -R $USER:$USER /opt/neuro_tools

这句命令把整个工具目录的属主改成当前用户。参数说明：-R递归作用于所有子目录，$USER:$USER表示用户和用户组都用当前登录用户。如果不改，后面跑批处理时会频繁遇到“Permission denied”，因为 CAT12 需要在目录下生成临时中间文件。

3.2 用 startup.m 自动加载路径，而不是手工 set path

很多人习惯打开 MATLAB 后用图形界面的“设置路径”手动添加 SPM12 和 CAT12，这个操作当时有效，但下次启动就没了。因为 MATLAB 的路径设置如果没有保存到pathdef.m，或者savepath写入失败，重启后一切归零。对于要长期使用的部署，我建议在 MATLAB 启动目录或用户配置目录下维护一个startup.m，每次启动自动加载路径：

% startup.m spm_root = '/opt/neuro_tools/spm12'; cat_root = '/opt/neuro_tools/cat12'; addpath(spm_root); addpath(cat_root); % 初始化 SPM12，生成默认参数 spm('defaults', 'fmri'); spm_jobman('initcfg');

代码逻辑说明：前三行把两个工具包的根目录加入 MATLAB 搜索路径，addpath的顺序有讲究，我在下面的“排错”章节会细说。spm('defaults', 'fmri')是初始化 SPM12 的全局参数，这个命令在 CAT12 启动时也会显式或隐式调用，提前执行可以避免后续cat12命令报“SPM 未初始化”。最后一行spm_jobman('initcfg')初始化批处理队列配置，跑任何 job 之前都需要它。

写完startup.m后，放到 MATLAB 启动时的工作目录下，或者放到userpath指定的目录里。可以用userpath命令查询：

userpath

ans = '/home/yourname/Documents/MATLAB'

把startup.m放到这个目录下即可，MATLAB 每次启动都会自动执行。我之所以推荐这种方式而不是图形界面保存路径，是因为startup.m是纯文本，本身就在版本控制范围内，换机器或重装 MATLAB 时一行命令就能恢复全部路径配置。而pathdef.m里存的是绝对路径列表，换目录后还要重新生成。这个习惯在多次迁移中帮我省下了至少半天时间。

3.3 可选：安装 CAT12 独立版做无图形界面批处理

如果你的使用场景是把 CAT12 部署在服务器上，用命令行提交 VBM 预处理任务，那么可以考虑装一个独立版本，而不是每次都以完整 MATLAB 图形界面启动。独立版通过一个命令行工具调用，不需要打开 MATLAB 窗口，适合在 SSH 会话里后台跑。典型启动命令是：

./cat_standalone.sh -i input.nii -o output_dir

参数说明：-i指定输入 T1 结构像，-o指定输出目录。独立版的好处是不依赖桌面环境，也不吃 Java 图形栈，恰好绕开了“MATLAB 图形界面闪退”那一类兼容性问题。缺点是需要单独安装 MATLAB Runtime 组件，体积比 MATLAB 本体小很多，并且安装时会有一个自动配置步骤，照着提示选择版本即可。如果你的批处理任务很多，我建议默认用独立版；如果只是偶尔在个人电脑上看个分割结果，完整版已经够用，不需要额外折腾这一层。

还要注意，独立版与完整版对批处理脚本的读取方式略有差异。独立版一般通过 JSON 或命令行参数调用，完整版则统一走 SPM 的 job 结构。两者在参数数值上完全一致，不要担心结果有差异。我曾在同一台机器上用两种方式跑同一个预处理任务，输出文件里的指标数值完全一致。

4. 跑通一个最小批处理任务：从 GUI 到 spm_jobman

4.1 理解 CAT12.7 的启动流程与参数文件

安装完成后，第一次启动可以直接在 MATLAB 命令行输入cat12。正常情况下，CAT12 会唤起一个独立的图形界面窗口，里面包含Segment、VBM、Longitudinal等模块入口。这个界面的本质是把批处理参数打包成一个 job 结构，再交给 SPM12 的执行引擎去跑。

这里有一个容易误解的点：CAT12 界面上你勾选的每一个选项，最终都会体现在一个matlabbatch结构体里。换句话说，即使你完全不用 GUI，直接手写这个结构体，也可以得到完全等价的处理流程。因此，我建议把 GUI 理解成“参数编辑器”，而真正执行的是 SPM 的 job 管理器。理解了这一层，你就能解释很多奇怪现象，比如：界面勾了“输出 ROI 数据”，但命令行日志里没有，因为 GUI 保存到 job 时那一项没被正确写入。

CAT12.7 在启动时会读取一个参数文件，通常叫cat_defaults.m，里面保存了空间归一化、平滑核、阈值等默认选项。你可以通过cat_get_defaults函数读取当前生效的参数：

cat_get_defaults('extopts.print')

ans = 0

如果返回0，说明不打印额外过程信息。我一般会把'extopts.print'设为 1，这样批处理时能实时看到跑到哪一步。设置方式是编辑参数文件或者在脚本里调用cat_set_defaults。参数文件是文本形式，可以备份到你的配置目录，换环境时直接覆盖。这也是我推荐源码软件的原因之一，默认参数是肉眼可见的、可审计的，不像某些黑匣子软件只能通过界面点选。

4.2 最小 VBM 批处理脚本与参数说明

先给一个可以完整跑通的最简批处理脚本，这个脚本在 CAT12.7 加 SPM12 的环境下直接可用。它做的事情是：读入一个 T1 结构像，做分割、空间归一化、平滑，输出 VBM 预处理后的灰质/白质图像：

% run_cat12_batch.m clear spm('defaults', 'fmri'); spm_jobman('initcfg'); cat12('cat12'); matlabbatch{1}.spm.tools.cat.estwrite.data = {'/opt/neuro_tools/data/subject01_T1.nii'}; matlabbatch{1}.spm.tools.cat.estwrite.output.GM = 1; matlabbatch{1}.spm.tools.cat.estwrite.output.WM = 0; matlabbatch{1}.spm.tools.cat.estwrite.output.CSF = 0; matlabbatch{1}.spm.tools.cat.estwrite.opts.tpm = {'/opt/neuro_tools/spm12/tpm/TPM.nii'}; matlabbatch{1}.spm.tools.cat.estwrite.opts.affreg = 'mni'; matlabbatch{1}.spm.tools.cat.estwrite.opts.biasreg = 0.0001; matlabbatch{1}.spm.tools.cat.estwrite.extopts.print = 1; spm_jobman('run', matlabbatch);

逐行说明：第一行到第三行是初始化，确保 SPM 和 CAT12 的默认参数已经加载。matlabbatch是 SPM 批处理结构体，固定写法。.data那一行填你的 T1 数据路径，注意用单引号括起来，并且路径里不能有中文。.output.GM = 1表示输出灰质密度图，WM和CSF没需要就设 0，少生成两种文件能显著缩短运行时间。.opts.tpm指向 SPM12 自带的组织概率图模板，安装 SPM12 时这个文件就会在tpm子目录下。.opts.affreg = 'mni'是配准到 MNI 空间的方式，对常规成人数据选'mni'即可，儿童或病理脑数据可以用'eastern'或'no'。.extopts.print = 1打开过程日志，便于定位卡住的位置。

运行方式有两种。一个是在 MATLAB 命令行里直接执行：

run run_cat12_batch.m

另一个是把这段脚本保存为.m文件后用 MATLAB 的批处理模式运行，适合服务器场景：

matlab -nodesktop -nodisplay -r "run /opt/neuro_tools/run_cat12_batch.m"

其中-nodisplay表示不开图形界面，-r后面跟要执行的命令。用这种模式跑批处理，脚本里的初始化语句一个都不能少，尤其不能省略spm_jobman('initcfg')，否则提交 job 时直接报“JobManager 未初始化”。

4.3 并行计算与内存控制

CAT12 本身支持 MATLAB 并行池来加速多个被试的处理，但这里有一个度的问题。并行池开得太大，内存先爆。我的经验公式是：并行 worker 数不超过物理核心数的一半，且预留至少 8GB 给主进程。例如 16 核 64GB 内存的机器，开 4 个 worker 相对稳妥。在脚本里启用并行池：

% 在运行 job 之前开启并行池 parpool(4);

参数说明：parpool(4)创建一个包含 4 个 worker 的并行池。如果你不确定机器有多少核心，可以先执行：

feature('numcores')

ans = 16

看到核心数再决定parpool参数。并行池对多被试循环加速明显，但单被试单 T1 的 VBM 流程里几乎没有加速效果，因为单个分割任务无法拆分成多进程。所以，只有当你手头有几十个被试要批量跑时才值得开并行池。还有一个细节：并行池运行期间不要再用 MATLAB 图形界面做其他操作，容易出现 GUI 响应变慢甚至“假死”，这是 MATLAB 的绘图线程与并行计算抢占资源导致的常见现象，不是 CAT12 的 bug。

5. 常见问题排查：装完启动即崩的六个真实场景

5.1 打开 MATLAB 报“未定义函数 cat12”

现象：输入cat12后报Undefined function or variable 'cat12'，或者提示找不到cat12.m文件。

原因：最常见的有三种。一是 CAT12 目录没有加进 MATLAB 搜索路径；二是路径加了，但startup.m执行顺序不对，SPM12 在 CAT12 之后被加载，覆盖了某些同名函数；三是解压不完全，cat12.m主文件缺失。

解决：先确认文件存在：

ls /opt/neuro_tools/cat12/cat12.m

然后回到 MATLAB 重新加路径。这里要特别强调addpath顺序：SPM12 在前，CAT12 在后，因为 CAT12 会覆盖 SPM12 里的少数工具函数。正确顺序如下：

addpath('/opt/neuro_tools/spm12'); addpath('/opt/neuro_tools/cat12'); spm('defaults', 'fmri');

如果ls显示文件不存在，那就解压过程中出问题了，删除目录重新解压即可。不要把压缩包直接解压到已有目录上，会把旧文件和新文件混在一起。

5.2 MATLAB 直接段错误崩溃，连 red 报错提示都不给

现象：启动 CAT12 图形界面的瞬间，MATLAB 整个进程退出，终端里只留下类似Segmentation violation的日志，或者双击桌面图标后界面开都不开。

原因：这一类“启动即崩”在 CAT12.7 上多与 MATLAB 自带的 Java 图形栈不兼容有关，尤其集中在 MATLAB R2018a 到 R2021a 之间打开 CAT12 的绘图窗口时。经典的触发条件是：机器上有核显和独显两张显卡，MATLAB 用 OpenGL 初始化失败。另一个隐性原因是系统默认 Java 运行时被改过，MATLAB 内部 Java 与系统 Java 版本冲突。

解决：绕开图形界面。批处理场景其实不依赖 CAT12 的图形界面，用下面命令启动 MATLAB 跑脚本：

matlab -nodesktop -nojvm -r "run /opt/neuro_tools/run_cat12_batch.m"

-nojvm直接关闭 Java 虚拟机，CAT12 的批处理任务不依赖 Java，但代价是 MATLAB 的图形界面完全不可用。如果想保留图形界面，可以试着让 MATLAB 强制使用软件 OpenGL：

matlab -softwareopengl

第一次看到这种“玄学”时，我也觉得奇怪，但之后在多地部署的经验让我把-softwareopengl写进了默认建议。它的原理是绕开显卡驱动对 OpenGL 的错误实现，代价是图形渲染稍微变慢。我一般建议：能接受无界面的场景就用-nojvm，不能接受就先用-softwareopengl试，依然崩溃再走无界面路线。

5.3 批处理进度条卡在 Initialize 不动

现象：spm_jobman('run', matlabbatch)执行后，日志停在某个阶段的初始化位置，CPU 占用接近零，等了半小时没有任何进展。

原因：这个场景的根因多数不在代码，而在工作目录的写权限。CAT12 在分割前会往输出目录写入中间格式文件，如果输出目录在/opt等受保护路径下而且当前用户不是属主，进程不会报错，而是静默等待。

解决：在脚本开头强制指定可写的工作目录，并在该目录下确认能创建文件：

cd('/opt/neuro_tools/data');

再检查权限：

ls -ld /opt/neuro_tools/data

如果属主不对，用chown改过来。这里我吃过哑巴亏，当时以为是操作系统的文件锁问题，找了一圈才发现只是目录权限没到位。另一个可能原因是多个 MATLAB 进程同时跑批处理，输出目录一样，临时文件相互冲突。如果确认可能有重复进程，为每个任务分配独立输出目录：

mkdir -p /opt/neuro_tools/data/run_$(date +%Y%m%d_%H%M%S)

5.4 批处理报错提示 mex 编译失败，缺少编译器

现象：跑分割时报MEX file ... was compiled for use with MATLAB ...或者提示找不到mex可执行文件。

原因：如果你用的是源码包，而不是预编译包，那么 MATLAb 在首次调用某些函数时会尝试自动编译 MEX 文件。此时若系统里没有对应 MATLAB 版本匹配的 C 编译器，编译直接失败。如果你的包是预编译包，则可能是因为你下载的是 Windows 版却跑在 Linux 上，文件后缀都不对。

解决：优先下载与操作系统匹配的预编译包，避免触发自动编译。如果已经用了源码包，选择安装匹配编译器。Linux 下安装 gcc：

sudo apt install gcc make

然后在 MATLAB 里设置编译器：

mex -setup

mex -setup会列出系统里可用的编译器，选择与你 MATLAB 版本兼容的那个。注意，MATLAB R2019b 以后，Windows 上推荐用 MinGW-w64，而不是旧版 Visual Studio。这个坑的特点是：报错信息通常不是直接说“缺编译器”，而是给你一个找不到某条命令的错误，新手容易误解成安装包损坏。

5.5 数据路径含中文或空格导致批处理中断

现象：job 提交时报Error using ... Cannot open file ... No such file or directory，文件路径看起来完全没问题，但就是打不开。

原因：CAT12 内部的某些 C/MEX 层对非 ASCII 路径支持不完整。路径中含中文、日文或首尾空格，都可能使底层文件打开调用失败。中文 Windows 用户名导致的路径问题尤其常见。

解决：统一把所有数据、脚本、工作目录改成纯英文小写路径。如果在 Windows 上，尽量避免把工作目录放在C:\Users\张三\下面。如果数据已经在中文路径下，可以用软链接或目录别名指向英文路径：

ln -s /data/原始_中文目录 /data/raw_english

然后 MATLAB 里用/data/raw_english路径。这不算一个完美解决，但能立刻让流程跑起来。同时把项目里的文件名改成subj01_T1.nii这种格式，避免文件名里的空格和特殊符号。

5.6 同一机器装了多个 SPM 版本，路径互相干扰

现象：SPM12 和 CAT12 的 GUI 能正常打开，但批处理时调用的函数来自旧版 SPM8，或which显示的函数路径不对。

原因：机器上同时有 SPM8、SPM12 多个版本，startup.m把多个目录都加了进去，MATLAB 按addpath的顺序优先使用排在前面的目录。SPM8 的某些函数与 CAT12.7 不兼容，导致行为异常。

解决：我现在的做法是“一机只保留一个 SPM 主版本”。如果实在需要保留多版本，至少把不用的版本从当前路径里完全移除：

rmpath('/opt/neuro_tools/spm8'); savepath;

然后通过which检查当前生效的函数位置：

which spm

能返回 SPM12 目录下路径才算清理干净。这个问题隐蔽性很高，因为版本混用不一定报错，可能只是某几个指标算出来与官方结果对不上。装 CAT12.7 前，先跑一下which确认 SPM 来源，比什么都管用。

6. 装完怎么验证跑通：用示例数据完成一次完整预处理

6.1 启动验证：版本号与参数文件质检

安装完成后，我建议按下面三件事依次验证，不是打开界面看一眼就算完。第一步，确认版本：

cat_version

ans = '7.x'

能返回版本字符串，说明主程序文件被正确加载。第二步，读取默认参数，再手动重置：

cat_defaults;

这一步会在 MATLAB 工作区生成一个cat结构体变量，如果报错，说明cat_defaults.m路径未生效或依赖的 SPM 函数缺失。第三步，用which检查关键文件：

which cat_parallelize

/opt/neuro_tools/cat12/cat_parallelize.m

确认所有关键函数都落在/opt/neuro_tools/cat12/目录下，而不是落在某个已经被覆盖的旧版本路径里。这套验证大约两分钟，换来的是后续所有操作都在确定的环境里执行，省心很多。

6.2 用示例数据跑通一次 VBM 预处理

不要直接用你在网上下载的真实数据做验收，那会拖慢验证进度，而且一旦报错，你分不清是安装问题还是数据问题。CAT12 的发布包里通常带有示例数据，也可以在 SPM12 的教程数据里找一份标准 T1。完整跑一遍的时间在 10 到 30 分钟之间，取决于 CPU 性能。

我的验收标准是：上述第 4.2 节的最小脚本从头跑到尾，日志出现 “Done” 并且生成以下三个产出文件：

mri/msubject01_T1.nii % 分割后的灰质密度图 mri/p0subject01_T1.nii % 空间归一化后的 T1 图像 report/subject01_T1_cat.txt % 质量检查报告

对 VBM 分析来说，p0开头的归一化图像是后续统计的输入，cat.txt报告里则包含整体质量评分、灰质体积等关键数字。拿到这三个文件后，我还会顺手打开cat.txt看一眼头几行：

head -20 /opt/neuro_tools/data/report/subject01_T1_cat.txt

确认里面没有NaN和error字段，并且给出了“image quality rating”的分数。只要有数值，说明分割流程的数值计算没有崩溃。这步验证完成后，你的 CAT12.7 才算真正确认可用，之后换真实数据心里就有底了。

6.3 把验证流程固化为部署检查清单

每次在新机器上部署完，我都会把三个固定动作重复一遍：先跑cat_version确认版本，再跑which cat_parallelize确认路径，最后用同一份示例数据跑一次最小批处理。这份示例数据和脚本我固定放在一个独立目录里，不随项目动。这样做的好处是，机器环境有任何变动，比如 MATLAB 升级、SPM12 更新，我都能用同一套标准动作来验证，不需要重新造轮子。

从那以后，我再也没在没有验证的情况下直接跑大批量任务。任何环境安装，都强制走一遍示例数据流程，确认产物文件完整再上真实数据。装 CAT12.7 这半天的功夫，最终都落在这三步验证上。希望帮到你。

本文还有配套的精品资源，点击获取