musicfree歌单导入失败的四大原因及解决方案：一是链接非原始平台纯url，需从qq音乐或网易云官网复制以https://y.qq.com/n/ryqq/或https://music.163.com/#/playlist?id=开头的链接；二是插件未启用或版本过低，需在设置中启用对应插件并更新至0.2.0以上；三是歌单设为私密，须设为公开后操作；四是可使用直连js脚本导入，将歌单id填入importmusicsheet("163","id")并拖入主窗口执行。
MusicFree歌单导入失败时页面只显示“链接有误”或“导入失败”，既不提示具体原因，也不保留已粘贴的链接，反复尝试浪费大量时间。这个问题在QQ音乐、网易云音乐歌单导入场景中高频出现，尤其当用户复制的是好友分享链接而非原始平台链接时几乎必然失败。
确认链接来源是否合规
第一步：打开你复制链接的原始平台（如QQ音乐APP或网页版），重新进入该歌单页面；
第二步：不点击“分享给好友”，而是找“复制链接”或“分享到微博/微信（仅链接）”这类纯URL选项；
第三步：粘贴新复制的链接到MusicFree导入框，注意检查链接是否以 【https://y.qq.com/n/ryqq/】 或 【https://music.163.com/#/playlist?id=】 开头——只有这类结构才被插件识别，好友分享链接通常含临时token参数，会被直接拒绝。
检查插件是否已启用并匹配平台
方法一：进入MusicFree「设置 → 插件管理」，查看列表中是否存在对应平台插件（如“QQ音乐”“网易云音乐”）；
方法二：若存在但状态为灰色或显示“未启用”，点击右侧开关按钮启用；
方法三：若插件名称后标注“（已过期）”或版本号低于0.2.0，请点击插件右下角「更新」或「重装」；旧版插件无法解析2025年之后QQ音乐新改版的URL结构，强行使用会导致静默失败且无报错提示。
处理默认歌单与隐私设置冲突
网易云用户必须新建一个公开歌单，把目标歌曲先复制进去，再对该新歌单执行分享→复制链接→导入；
QQ音乐用户需进入歌单右上角「⋯」→「编辑歌单」→关闭「仅自己可见」开关；
【MusicFree无法访问任何设为私密的歌单，哪怕你是该歌单创建者】，系统不会校验登录态，只按公开链接抓取数据。
跳过前端限制的直连方案
打开任意文本编辑器，新建文件，输入以下内容（以网易云为例）：
importMusicSheet("163", "歌单ID数字部分")
将其中“歌单ID数字部分”替换成你歌单URL里 question mark 后的id值（例如 https://music.163.com/#/playlist?id=2894723871 中的 2894723871）；
保存为 .js 文件（如 netease-import.js），拖入MusicFree主窗口，松手即触发导入——此方式绕过所有前端校验逻辑，适用于链接解析失败但ID明确的场景。
