AI 開發 2026年9月7日 約 28 分鐘 SPM 25.01.02 SPM12

SPM 25.01.02 還是 SPM12:2026 神經影像專案怎麼選

本文不以功能清單判斷版本,而是按研究者、腳本維護者、學生與課題組管理者的實際責任分流。新課題預設採用 SPM 25.01.02,在研論文保留 SPM12,正在遷移的專案則以隔離環境完成雙軌回歸後再決定。

SPM 25.01.02 還是 SPM12:2026 神經影像專案怎麼選

本文不以功能清單判斷版本,而是按研究者、腳本維護者、學生與課題組管理者的實際責任分流。新課題預設採用 SPM 25.01.02,在研論文保留 SPM12,正在遷移的專案則以隔離環境完成雙軌回歸後再決定。

截至 2026 年 9 月 7 日,SPM 官方 GitHub 發行頁將 25.01.02 標為最新穩定發行版;因此,新課題直接選 SPM 25.01.02,在研論文、歷史復現或深度依賴舊腳本的專案則先保留 SPM12,遷移時必須在隔離環境中雙軌回歸,而不是覆蓋原有環境。官方發行頁 可核對這項版本狀態。

症狀:實驗室要在 Apple Silicon Mac 上開始或遷移 SPM,但新舊版本、MATLAB 授權和舊腳本互相牽制。
最快解法:新課題採用 SPM 25.01.02;在研論文保留 SPM12;遷移中的專案建立兩套獨立環境,以代表性資料決定是否切換。

這篇文章適合三類讀者:首次搭建 fMRI、PET、EEG 或 MEG 環境的研究生;正在使用 SPM12 完成論文或復現歷史結果的科研人員;以及負責 Apple Silicon Mac、MATLAB 授權和課題組環境交付的技術支援人員。

01

先按研究階段分流版本

版本選擇不應從「哪個版本功能較新」開始,而應先看研究結果是否已經被舊環境綁定。SPM 官方版本號說明可用來核對版本命名與發行狀態;其中尚未成為穩定版的預發布版本,不應直接納入生產科研流程。SPM 官方版本號說明 提供了核對依據。

研究狀況 預設選擇 必須保留的證據 停止或回退條件
全新課題,沒有歷史環境 SPM 25.01.02 版本輸出、介面啟動、最小批次、結果檔案 最小流程無法完成,或核心工具箱未能使用
已投稿、審稿或準備補充分析 先保留 SPM12 原始 SPM.mat、腳本、設定、輸入資料 新版輸出差異無法由參數或資料解釋
需要復現舊論文或實驗室既有結果 SPM12 為基線 舊環境資訊與歷史輸出 尚未建立可比較的雙軌結果
維護自訂 MATLAB 腳本或第三方工具箱 SPM12 + SPM 25.01.02 雙軌 函式、批次欄位、MEX、工具箱聲明及錯誤記錄 任何無法解釋的錯誤或結果差異
沒有 MATLAB 授權 先評估 Standalone Runtime、介面、批次方式與擴充需求 自訂 MATLAB 程式或額外工具箱無法驗證

SPM12 已被官方相容性頁面列為不再支援的舊版本,但「不再支援」不等於既有論文可以立即改版。對已經產生結果的研究而言,版本本身也是方法的一部分。SPM12 官方相容性說明 應與原始研究紀錄一起保存。

02

新課題的 SPM 25.01.02 基線

首次使用 SPM 的研究者,通常沒有必要為了配合舊教材而主動建立 SPM12 環境。只要課題沒有既定腳本、歷史輸出或指定的第三方工具箱,SPM 25.01.02 更適合作為新流程的初始基線。

這個判斷有三個限制條件。第一,必須先核對官方穩定發行狀態,而不是把預發布版本當成生產版本。第二,必須使用官方建議的安裝路線建立環境。第三,不能把「圖形介面能打開」誤當成整個研究流程已通過。

SPM 官方安裝說明 所描述的安裝方式,應成為新課題的起點。完成後,至少要留下以下驗收資料:

驗收項目 通過證據 不通過時的處理
版本識別 命令列或 MATLAB 輸出清楚顯示 SPM 版本 截圖不足時,保存完整文字輸出
圖形介面 SPM 主介面可啟動,路徑沒有混入舊版本 清理 MATLAB 路徑後重新測試
最小批次 使用代表性小資料完成一次最小流程 記錄錯誤,不直接換成另一版本
結果生成 預期的結果檔案、記錄檔與目錄結構正常產生 檢查寫入權限和輸入資料
可重建性 另一個乾淨工作目錄可重做同一流程 若只能依賴個人啟動設定,暫停交付

新課題最好在正式收集或處理全量資料前完成這個基線。否則日後發現路徑、授權或工具箱問題時,研究者很難分辨問題來自 SPM、MATLAB、資料本身,還是課題組共用設定。

03

在研論文的 SPM12 凍結策略

正在投稿、審稿、撰寫補充分析或復現既有論文的研究者,優先考慮保留 SPM12。原因不是 SPM 25.01.02 一定會產生不同結果,而是升級會同時改變多個可能影響結果的條件:函式實作、預設值、MATLAB 路徑、擴充套件、MEX 載入方式,以及作業系統環境。

SPM12 官方發布說明可作為舊環境的文獻依據,但不能代替課題組自身的環境封存。SPM12 發布說明 建議與以下資料一併保存:

  • 原始 SPM.mat 與批次腳本;
  • 輸入影像、遮罩、行為資料及其雜湊值;
  • SPM、MATLAB、macOS、工具箱與自訂程式碼版本;
  • 啟動檔案、MATLAB 路徑和預設參數;
  • 歷史輸出、統計圖、錯誤記錄與人工修正紀錄。

提醒:論文正在進入關鍵節點時,版本升級不應與投稿、審稿回覆或主要結果重算同時進行。先複製環境,再在副本測試;原始環境應保持只讀。

若確實需要新版功能或新的 Apple Silicon 部署方式,先以脫敏資料完成小規模比較。比較項目不只包括最終圖片,也要包括關鍵統計值、輸出檔案結構、批次記錄和處理失敗的位置。只要差異尚未能由明確的設定變更解釋,就回到 SPM12。

04

自訂腳本與第三方工具箱的雙軌回歸

對維護實驗室模板、MATLAB 腳本或 SPM 擴充的開發型使用者而言,版本遷移不是重新安裝,而是一次相容性審查。即使 SPM 25.01.02 的介面能開啟,也不能據此推論所有舊程式可直接執行。

建議依照以下順序檢查:

一、搜尋腳本中的 SPM 函式呼叫、硬編碼路徑與自訂 callback。
二、逐項比對批次欄位名稱、資料型別與預設參數。
三、檢查第三方工具箱的官方說明是否明確列出新版支援範圍。
四、確認 MEX 檔案是否為目前 Apple Silicon 環境可載入的架構。
五、在相同脫敏輸入資料上執行舊版與新版。
六、保存完整錯誤日誌、輸出檔案和差異摘要。

SPM 官方 MEX 編譯文件說明了原生二進位元件在環境遷移時需要獨立處理;MathWorks 的 MEX 平台相容性文件 也指出,MEX 檔案的平臺架構必須與執行環境相容。因此,遇到 MEX 載入錯誤時,不能只重新加入 MATLAB 路徑。

回歸層級 測試內容 可接受結論
函式層 自訂函式、路徑與輸入欄位 所有警告均可解釋
批次層 完整批次流程與依賴順序 不需手動改動即可完成
結果層 關鍵統計值、影像與輸出結構 差異符合預先定義的判準
交付層 乾淨帳戶或新工作目錄重建 不依賴個人隱藏設定
回退層 SPM12 原流程再次執行 舊結果仍可被重現

任何無法說明的輸出差異都應觸發回退,而不是以「大致相同」作為通過理由。這也是雙軌方案比直接覆蓋舊環境更適合研究用途的地方。

05

沒有 MATLAB 授權時的 Standalone 邊界

學生或課題組若沒有 MATLAB 授權,可以評估 SPM 25 的 Standalone 路線,但要先確認任務是否真的適合。SPM 官方提供 Standalone 安裝與使用說明,這條路線可能降低授權門檻,卻不代表所有 MATLAB 程式碼和額外工具箱都能原樣帶入。

評估時應拆開四件事:

  • MATLAB Runtime 是否能在目標 Apple Silicon Mac 上正常使用;
  • 圖形介面是否符合研究者的操作需求;
  • 批次處理能否由檔案或命令方式穩定重做;
  • 自訂 MATLAB 程式、額外工具箱和第三方擴充是否在 Standalone 邊界內。

若流程只是使用標準介面完成固定分析,Standalone 值得先做小樣本驗證。若流程依賴自訂 MATLAB 程式、特殊工具箱或實驗室多年累積的腳本,則不能只因為不需要購買授權就直接選用。研究者應先完成一組代表性任務,再決定是否將它作為正式環境。

06

Apple Silicon Mac 的隔離部署

Apple Silicon 的重點不只是遠端畫面是否順暢,而是主機端架構、MEX 載入、MATLAB 路徑和長時間批次是否穩定。SPM 25.01.02 與 SPM12 不應共用混亂的啟動檔案、可寫目錄或未審查的 MATLAB 路徑。

MathWorks 的 Apple Silicon 支援文件 可用來核對 MATLAB 對 Apple Silicon 的支援範圍;SPM 官方 MEX 編譯說明 則應用於處理原生二進位元件,而不是用來推斷所有第三方擴充都已相容。

建議按照以下步驟落地:

一、建立兩個獨立的 SPM 目錄,禁止新版直接覆蓋舊版。
二、為兩個版本分別設定 MATLAB 路徑和啟動檔案。
三、分開指定暫存目錄、輸出目錄與可寫工作目錄。
四、先驗證原生架構、MEX 載入和圖形介面,再測試批次流程。
五、使用同一份脫敏資料執行代表性任務,保存輸出與日誌。
六、測試遠端圖形操作、長時間連線、批次連續執行和成果下載。
七、把網路操作體驗與主機端計算結果分開判定。
八、為每個專案指定回退版本、負責人與停止條件。

經驗:遠端螢幕延遲只能說明互動體驗,不足以解釋 SPM 的計算效能或結果差異。批次是否完成、檔案是否正確生成,應以主機端日誌和輸出資料判斷。

如果實驗室沒有可用的 Mac,先參考 Apple Silicon Mac 遠端科研環境 的連線方式,再決定是否需要建立短期測試環境。對只需要驗證版本、腳本或工具箱的課題,按週或按月取得一台具完整權限的遠端 Mac,通常比為一次遷移測試提前採購實機更容易控制。

07

課題組管理者的生命週期規則

技術支援人員不應替所有課題組成員安裝同一個版本。較穩妥的管理方式,是依專案生命週期建立三種環境:

  • 新課題:以 SPM 25.01.02 建立標準基線;
  • 歷史課題:封存可重現的 SPM12 環境;
  • 遷移課題:同時維護 SPM12 與 SPM 25.01.02,直到回歸證據足夠。

每個專案都應有一份環境紀錄,至少包括 SPM、MATLAB、macOS、Apple Silicon 架構、擴充套件、腳本版本、資料位置與回退方法。若成員只收到一個可登入的遠端帳戶,卻沒有路徑、授權和輸出目錄規則,後續問題仍會集中回到管理者身上。

我們建議把「停止遷移」寫成明確條件:MEX 無法載入、關鍵批次欄位行為改變、統計輸出差異無法解釋、Standalone 缺少必要工具箱,或長時間批次無法穩定完成時,立即回到 SPM12。這比以日期或「新版已發布」作為切換依據更可靠。

08

簡短評分與最終判斷

以下評分不是對軟體功能的排名,而是以科研交付風險作為尺度;分數越高,代表在該類場景越容易建立可控流程。

使用情境 SPM 25.01.02 SPM12 建議
全新神經影像課題 5/5 3/5 預設選 SPM 25.01.02
在研論文與歷史復現 2/5 5/5 先保留 SPM12
自訂腳本與擴充維護 3/5 4/5 雙軌回歸
無 MATLAB 授權的學生 需驗證 需驗證 先評估 Standalone 邊界
Apple Silicon 遷移 4/5 4/5 分離路徑與目錄後比較
課題組長期管理 5/5 5/5 新舊專案分層管理

最終可以用以下條件作決定:沒有歷史結果負擔,就選 SPM 25.01.02;已有論文結果或固定腳本,就保留 SPM12;需要遷移,就雙軌執行,並以代表性資料和預先定義的通過標準收尾。

09

常見問題

新建神經影像專案的版本基線

全新建立的 fMRI、PET、EEG 或 MEG 專案,若沒有必須延續的舊環境,建議以 SPM 25.01.02 建立基線。先完成版本輸出、圖形介面、最小批次和結果檔案驗收,再擴展到完整資料。

SPM12 批次腳本的直接相容性

SPM12 腳本不能僅因為能在新版介面中開啟,就被視為已完成相容。應檢查函式呼叫、批次欄位、預設參數、MEX 檔案與第三方工具箱,並以相同脫敏資料比較關鍵輸出;無法解釋的差異都應觸發回退。

沒有 MATLAB 授權的 Standalone 選擇

SPM 25 Standalone 可以作為沒有 MATLAB 授權時的候選路線,但必須確認 Runtime、圖形介面、批次方式和擴充套件需求。若研究流程依賴自訂 MATLAB 程式,請先完成小樣本驗證,不能只按授權成本選擇。

Apple Silicon 的雙版本保留方式

SPM 25 與 SPM12 應使用不同目錄、MATLAB 路徑、啟動檔案、暫存位置和輸出目錄。完成原生架構與 MEX 載入測試後,再執行圖形介面、批次連續處理和成果下載驗收,避免新版本覆蓋舊環境。

在研論文的升級風險

在研論文升級版本可能影響結果重現,因此不宜安排在投稿、審稿回覆或主要結果重算期間。請先保留只讀原始資料與 SPM.mat,在副本中完成雙軌比較;只有關鍵結果、檔案結構和處理記錄均符合標準,才考慮切換。

如果目前方案是共用 Linux 或 Windows 主機,常見限制包括沒有原生 macOS 環境、無法方便驗證 Apple Silicon 架構、多人共用 MATLAB 路徑容易互相污染,以及為一次版本回歸而長期維護閒置設備。對正在遷移 SPM 的課題組而言,這些成本往往比單純的硬體價格更難處理。

若實驗室需要的是短期驗證、跨版本回歸或交付前測試,租用 VNCMac 的遠端 Mac 可以提供完整權限與獨立環境,讓團隊同時保留 SPM12 和 SPM 25.01.02,再以同一份脫敏任務做出可追溯的判斷。可先查看 VNCMac 的 Mac 租用選項;若課題需要長期固定負載、直接連接本地儀器或必須完全離線,購買實機仍可能更適合。

FAQ(常見問題)

如果是全新建立的 fMRI、PET、EEG 或 MEG 分析流程,且沒有必須延續的歷史環境,建議先以 SPM 25.01.02 建立基線。請以官方發行頁、安裝文件、版本輸出、圖形介面啟動、最小批次與結果檔案作為驗收證據,而不是直接複製舊課程的 SPM12 設定。

不能只因為批次介面能開啟,就判定 SPM12 腳本已相容。應逐項檢查函式呼叫、批次欄位、預設參數、MEX 檔案與第三方工具箱,使用脫敏代表資料執行完整流程;任何無法解釋的輸出差異,都應保留 SPM12 並停止直接遷移。

可以先評估 Standalone 路線,但它不等於完整 MATLAB 環境。需要核對 MATLAB Runtime、圖形介面、批次執行方式,以及研究流程所依賴的自訂 MATLAB 程式與額外工具箱是否可用。若流程依賴自訂程式碼,應先用小型代表資料驗證,不能只按授權成本做決定。

兩個版本應放在彼此隔離的目錄,分別使用獨立的 MATLAB 路徑、啟動檔案、暫存位置與可寫資料夾。先確認原生架構與 MEX 載入,再分別測試圖形介面、批次連續執行及成果下載。不要讓新版本覆蓋舊版資料夾,也不要共用未經檢查的 startup 設定。

有可能,因此投稿、審稿或正在整理結果的專案不應把升級安排在關鍵節點。請保存原始 SPM.mat、批次腳本、預設設定、輸入資料與環境資訊,再於副本中執行新版回歸。只有在預先定義的關鍵輸出、統計圖與檔案結構均通過比較後,才適合考慮遷移。