科技 · 实用指南
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 风格路径。应重新生成或编辑目标端副本，不要覆盖母版，也不要为了某个导入程序重新整理音乐文件。如果精确路径确实存在但导入仍失败，请保留失败副本和脱敏后的错误示例，交给对应播放器的支持渠道。不要通过删除尚未解决的曲目条目，把导入伪装成成功。
