科技 · 實用指南
Windows 播放清單在 Linux 失效?修正路徑並保留順序
將斜線與根資料夾問題分開檢查。以播放清單副本對照目標媒體庫修正路徑,保留順序與重複曲目,確認錄音正確後再匯入其他清單。

Windows 的 M3U 播放清單原本能指向正確音樂,卻可能在音樂搬到 Linux 後失效。將反斜線改成正斜線只是其中一種修復:磁碟代號、清單所在資料夾,或伺服器看到的檔案路徑,仍可能不正確。保留 Windows 匯出檔不變,另外建立目標端副本來修正。
本指南適用於來源檔案仍存在的一般本機 M3U、M3U8 音樂清單,不修復 HLS 串流清單、不救回已刪除的錄音,也不保證所有播放器接受相同路徑格式。先用一份小清單試驗,不要直接對整個媒體庫批次取代。
先找一首目標端已能直接播放的曲目
在目標播放器或伺服器媒體庫直接開啟一首受影響的歌曲。若仍無法播放,應先處理檔案是否存在、存取權限或格式支援問題;重寫清單不能補出遺失的錄音。若直接播放正常,就將程式顯示的檔案位置,與文字編輯器中清單副本的對應行比較。
一篇歷史 Emby 論壇報告與另一條 Navidrome 問題紀錄,都描述了 Windows 匯出路徑中的反斜線造成 Linux 匯入失敗。它們證明此類遷移問題曾反覆出現,不代表那些舊版本的行為至今完全相同。應檢查目前安裝環境中的路徑,不要只憑舊問題報告就重新安裝軟體。
分清分隔符號與目標根目錄
以讀取清單的應用程式實際看到的路徑為準。Windows 共用位置、Linux 主機與容器,可能以不同名稱呈現同一批音樂。例如,D:\Music\Artist\Studio\01 Intro.wav 改完斜線後是 D:/Music/Artist/Studio/01 Intro.wav,仍帶著 Windows 根路徑。若目標端顯示 /music/Artist/Studio/01 Intro.wav,確認後的舊前綴就是 D:/Music/,應取代成 /music/。
在純文字編輯器中只修改本機曲目的路徑行,保留註解,並讓每條 #EXTINF 與後面的對應曲目保持配對。先改分隔符號,再取代已確認的開頭前綴,包括結尾斜線。逐行預覽受影響內容。不要全域取代 Music 這個字、改寫無關根目錄,或修改網址與中繼資料。清單跨兩個舊磁碟時,應分別確定兩份對映,而非猜一個通用對映。
相對路徑取決於清單放在哪裡
當 mix.m3u8 位於音樂根目錄時,Artist/Studio/01 Intro.wav 可能有效。若只將清單移到 Playlists 子資料夾,同一行便會指向 Playlists/Artist 下方。目標程式以清單資料夾為基準時,../Artist/Studio/01 Intro.wav 才能回到上一層音樂根目錄。另一種做法是在複製目錄樹時,讓清單維持原本的相對位置。
選擇相對或絕對路徑前,先查看目標端的匯入規則。WiiM 的 USB 清單指南明確要求相對路徑與 UTF-8,但這不是所有 Linux 伺服器的通用要求。目標端支援時,另存一份 UTF-8 副本,並確認含重音符號的檔名仍然正確。把解碼錯誤的檔案改名為 .m3u8,並不能修復其中的文字。
找到同名檔案,不代表找對錄音
不要預設透過刪除目錄、只保留檔名來修復。Artist/Studio/01 Intro.wav 與 Artist/Live/01 Intro.wav 可以同時存在,內容卻是不同演出。先比較完整的演出者與專輯路徑,再試聽選中的錄音。若仍無法唯一識別原檔,就將該項保留為未解決,而不是用方便找到的同名檔替代。
現有工具可以協助:X M3U Converter 文件提供明確的路徑取代與批次轉換功能;其遺失檔案重新定位依靠檔名,同名時偏好最接近的資料夾。ListPorter 專用於 Plex 匯入,支援明確路徑對映,模糊比對發生衝突時會停止。其匯入對映不會重寫原始 M3U 檔。應依目標端選擇工具,不要只因它顯示大量修復結果就認定正確。
核對整份清單,不只聽第一首能播放的歌
依順序比較原清單與修正版。每一筆本來要保留的曲目都應存在,包括刻意重複的曲目。只修路徑時,不要啟用排序、去除重複、捨棄遺失項目或破壞性的鏡像同步。檢查遺失檔案、精確拼字、大小寫與同名檔。接著匯入小型副本,核對項目數量、順序及重複項;每個對映根目錄與有歧義的專輯都應抽樣播放。
我們在合成的 Linux 檔案系統驗證了這些路徑範例:產生三個 WAV 檔,並在清單中引用六次。只改斜線時,六筆 Windows 根路徑均無法解析;精確對映根目錄後,六筆全部成功。把相對路徑清單移到子資料夾後,六筆又全部失效,修正相對基準才恢復。十六項斷言通過,涵蓋輸入與音訊雜湊不變、Unicode 路徑、中繼資料保留,以及兩個同名檔含有不同音訊。這是檔案系統測試,不是 Emby、Navidrome、Plex 或 WiiM 的應用整合測試。
保留一份主檔與可重複產生的目標端副本
小規模試驗通過後,保留未修改的 Windows 主檔、目標端副本,以及簡短的對映紀錄:舊前綴、目標應用看到的前綴、清單位置、編碼與驗證日期。只有目錄配置相同的清單,才能套用同一份已審核對映。保留例外清單;專輯改名或掛載點不同,都需要重新檢查。
後續從 Windows 匯出時,可能又會產生 Windows 風格路徑。應重新產生或編輯目標端副本,不要覆寫主檔,也不要為了某個匯入程式重整音樂。若精確路徑確實存在,但匯入仍失敗,請保留失敗副本與去識別化的錯誤範例,交給該播放器的支援管道。不要刪除尚未解決的曲目項目,讓匯入看似成功。
