PyNCM文件名模板教程用{title}、{artists}、{album}等7大参数定制下载命名规则【免费下载链接】pyncm第三方网易云音乐 Python API 转储工具项目地址: https://gitcode.com/gh_mirrors/py/pyncmPyNCM 是一款第三方网易云音乐 Python API 及个人音乐库转储工具也是很多音乐爱好者整理本地曲库的利器。本文将带你彻底搞懂PyNCM 文件名模板的用法只需掌握{title}、{artists}、{album}等 7 大参数就能为下载的每一首歌定制专属的下载命名规则告别「一堆乱码文件名」的尴尬。本教程面向新手无需写代码照抄命令即可上手。为什么要学 PyNCM 文件名模板默认情况下PyNCM 下载的歌曲会以{title}命名格式大致是「歌名 - 歌手1,歌手2」。听起来不错但当你批量下载整个歌单、整个专辑时就会遇到这些痛点几百首歌挤在一个文件夹里没有专辑/年份信息难以分类歌名与歌手混在一起播放器里显示混乱想按「年份」或「专辑内序号」排序默认命名无能为力而 PyNCM 的文件名模板--template参数就是解决这一切的钥匙。它支持 7 大占位参数可以自由组合成任意命名规则甚至还能把「输出文件夹」也用模板动态创建。认识 7 大模板参数一张表看懂 PyNCM 的文件名模板共支持 7 个参数全部定义在pyncm/utils/helper.py的TrackHelper.template属性中约第 263-273 行。每个参数对应一首歌的一个元数据字段参数含义示例值{id}网易云音乐资源 ID29732235{year}出版年份2024{no}歌曲在专辑中的编号3{album}专辑标题理想国{track}单曲标题平凡之路{title}完整标题曲名 - 歌手列表平凡之路 - 朴树{artists}艺术家名多个用/分隔朴树 / 张悬 小知识{title}实际上等于「{track} - {artists}」所以{track} - {artists}与{title}是等效的二者只保留一个即可。最快上手一行命令指定命名规则 ⚡文件名模板通过命令行参数传入PyNCM 提供了三个等效写法--output-name、--template和简写-t定义见pyncm/__main__.py第 591-606 行。安装并登录后直接这样用pip install pyncm pyncm https://music.163.com/song?id186016 --template {no} - {track} - {artists}上述命令下载后文件名会变成类似01 - 平凡之路 - 朴树的样子。如果想要「歌手 - 专辑 - 歌名」的格式只需pyncm 网易云分享链接 -t {artists} - {album} - {track}就是这么简单——模板里写什么文件名就是什么。模板渲染逻辑位于pyncm/__main__.py约第 389-394 行PyNCM 会先把 7 大参数填充进模板再生成最终文件名。进阶玩法用{album}自动创建专辑文件夹 ️文件名模板只能管文件名但 PyNCM 的-o/--output输出文件夹参数同样支持模板这意味着你可以让每首歌自动归入「以专辑命名」的子文件夹整个曲库瞬间井井有条。推荐命令按「歌手/专辑」双层归档pyncm 歌单链接 --output Music/{artists}/{album} -t {no} - {track}下载结果会自动生成类似Music/朴树/猎户星座/01 - 平凡之路.flac的目录结构。官方示例脚本 demos/歌单同步.py 也演示了这种用法——只需一条命令即可把整个歌单同步为「NetEase/[专辑名]」的本地目录python ./demos/歌单同步.py --load .pyncm --quality hires --output NetEase/{album}同理{year}也常被用来做「按年份归档」--output Music/{year}想按年代回顾自己的听歌历史时非常方便。中文用户的福音非法字符自动转全角 ️细心的你可能会问歌名里万一有\ / : * ? |这些 Windows 不允许出现在文件名里的字符怎么办别担心PyNCM 内置了SubstituteWithFullwidth函数见pyncm/utils/helper.py第 12-13 行会自动把这些非法半角字符替换成对应的全角字符如:→、?→保证文件在 Windows、macOS、Linux 上都能正常保存。所以你大可以放心使用任何模板组合。3 个实用模板组合直接抄作业 ✍️场景推荐模板效果示例单曲收藏{track} - {artists}平凡之路 - 朴树专辑整包下载{no:02} - {track}01 - 平凡之路按曲序排列资料库归档{artists}/{year}/{album}/{track}朴树/2003/生如夏花/傲慢的上校提示第 3 个组合需要配合--output参数使用且{artists}、{year}、{album}这些路径片段会被 PyNCM 自动创建成多级文件夹。常见问题 FAQ ❓Q1模板参数大小写有要求吗有。参数必须严格使用小写如{artists}写成{Artists}将无法被替换。Q2忘了有哪些参数怎么办在命令行输入pyncm -h查看帮助--output-name一节的说明里就完整列出了 7 大参数及示例。Q3模板参数为空时会怎样PyNCM 的元数据解析带有默认值保护Default装饰器见pyncm/utils/helper.py第 16-29 行缺失的字段会回退为Unknown等兜底值不会导致下载中断。Q4还想更花哨的命名比如带音质标签命名模板目前仅支持上述 7 个歌曲元数据参数音质由--quality单独控制可在下载后用批处理统一重命名。小结 ✨掌握 PyNCM 文件名模板本质就是掌握 7 个参数{id}、{year}、{no}、{album}、{track}、{title}、{artists}。它们既可以用来定制单个文件名也可以配合--output自动生成多级目录配合全角转义保护足以应对任何歌曲命名场景。从今天起用一条模板命令让本地曲库从此整整齐齐吧想了解更多 PyNCM 的玩法它的 API 调用、歌单同步、云盘上传等功能同样值得探索欢迎持续关注本系列教程。【免费下载链接】pyncm第三方网易云音乐 Python API 转储工具项目地址: https://gitcode.com/gh_mirrors/py/pyncm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
