企业官网建设流程全解析

告别杂乱文件：netease-cloud-music-dl自定义命名格式与智能文件夹分类的4项设置详解

【免费下载链接】netease-cloud-music-dlNetease cloud music song downloader, with full ID3 metadata, eg: front cover image, artist name, album name, song title and so on.项目地址: https://gitcode.com/gh_mirrors/ne/netease-cloud-music-dl

netease-cloud-music-dl（命令行工具名ncm）是一款基于 Python 的网易云音乐命令行下载器，可批量下载高品质 MP3，并自动把专辑封面、歌手名、专辑名等完整 ID3 元数据写入文件。下载上百首歌曲后，本地曲库如何不乱？本文带你详解ncm.ini配置文件中的 4 项核心设置——自定义命名格式与智能文件夹分类，几分钟完成配置，让本地音乐库从出生那天起就井井有条。

🚀 快速上手：3 步安装并调用 ncm

1. 确保已安装 Python 3.x
2. 在项目根目录执行python3 setup.py install（安装配置见 setup.py）
3. 用ncm -h查看帮助，再用ncm -s 歌曲id或歌曲URL下载单曲

完整的下载命令清单（单曲、专辑、歌单、播客、电台）可查阅 README.md。

⚙️ 配置文件：首次运行自动生成

第一次运行 ncm 时，它会在用户主目录下自动生成配置文件ncm.ini（默认模板与生成逻辑见 ncm/config.py）：

用任意文本编辑器打开即可修改。本文要讲解的 4 项设置全部在这一段里：

[settings] download.hot_max = 50 download.dir = /home/username/.ncm/download song.name_type = 1 song.folder_type = 1

设置 1：download.dir —— 一键指定下载目录

download.dir决定所有音乐文件的落盘位置，默认是用户目录下的.ncm/download（定义见 ncm/config.py）。

建议把它改成你自己管理的音乐盘，例如：

download.dir = /home/username/Music/NetEase

这样配合后面的分类设置，目录结构会更清晰。

设置 2：song.name_type —— 音乐文件命名格式怎么选

song.name_type控制下载下来的 MP3 文件名长什么样，共 3 种可选格式（实现位于 ncm/downloader.py）：

💡小建议：如果你下载多位歌手的歌曲，选2或3更容易一眼识别，也方便在音乐播放器里检索；只下载单一歌手的专辑时，1更简洁。

另外不用担心文件名"脏字符"问题：工具会自动把\ / : * ? " < > |等非法字符替换为空格（见 ncm/downloader.py），保证文件在所有操作系统上都能正常保存。

设置 3：song.folder_type —— 智能文件夹分类

song.folder_type是整理本地曲库的关键，支持 3 种目录结构（实现位于 ncm/downloader.py）：

推荐设为3，效果如下：

Music/NetEase/ ├── 周杰伦/ │ ├── 叶惠美/ │ │ ├── 晴天.mp3 │ │ └── 七里香.mp3 │ └── 范特西/ └── 林俊杰/ └── 江南/ └── 江南.mp3

⚠️注意：智能分类只对单曲 / 多首下载命令-s、-ss生效。使用批量命令时，ncm 会自动在download.dir下创建带后缀的专属文件夹，方便管理（见 ncm/start.py）：

设置 4：download.hot_max —— 控制热门歌曲批量下载数量

使用ncm -hot 歌手id下载歌手热门歌曲时，默认下载 50 首。通过download.hot_max可调整数量，取值范围0 < hot_max <= 50。例如只想试听最火的 20 首：

download.hot_max = 20

💡 配置组合推荐

总结：4 项设置速查

修改 ncm.ini 后无需重启任何服务，下次运行ncm时配置即生效（配置加载逻辑见 ncm/config.py）。所有歌曲下载完成后，封面与元数据会自动嵌入 MP3（实现见 ncm/file_util.py），已下载过的文件也会自动跳过。把命名格式和文件夹分类这两项设置好，你的本地音乐库就能彻底告别杂乱。

【免费下载链接】netease-cloud-music-dlNetease cloud music song downloader, with full ID3 metadata, eg: front cover image, artist name, album name, song title and so on.项目地址: https://gitcode.com/gh_mirrors/ne/netease-cloud-music-dl