3步解锁网易云音乐NCM格式，让音乐自由播放

ncmdump是一款免费开源工具，能将网易云音乐的.ncm缓存文件转换为通用的.mp3或.flac格式，帮你摆脱平台限制，真正拥有音乐文件。

为什么选择ncmdump？

当你下载的网易云音乐只能在官方APP播放，想在其他设备欣赏收藏的音乐，或需要备份却受限于专有格式时，ncmdump就是你的解决方案。它让你彻底告别格式束缚，享受音乐自由。

核心功能

• 无损音质转换：支持.ncm到.mp3和.flac格式的完美转换，保持原始音频质量，让你享受原汁原味的音乐体验。

• 全字符兼容：全面支持中文、日文、韩文及表情符号等所有UTF-8字符，彻底解决文件名乱码问题。

• 跨平台使用：可在Windows、macOS和Linux系统上稳定运行，满足不同用户的使用需求。

如何使用ncmdump？

获取工具

通过以下命令获取最新版本：

git clone https://gitcode.com/gh_mirrors/nc/ncmdump

编译安装（可选）

如果你是开发者或需要最新功能，可以自行编译：

cmake -DCMAKE_BUILD_TYPE=Release -B build
cmake --build build

开始转换

基本操作：

• 转换单个文件：ncmdump 歌曲.ncm
• 批量转换多个文件：ncmdump 1.ncm 2.ncm 3.ncm

文件夹处理：

• 处理整个文件夹：ncmdump -d 音乐文件夹
• 递归处理子目录：ncmdump -d 音乐文件夹 -r
• 指定输出位置：ncmdump -d 源文件夹 -o 目标文件夹

实用场景

个人音乐库整理

将下载的网易云音乐.ncm文件批量转换为标准格式，建立属于自己的数字音乐收藏馆，方便管理和查找。

多设备同步播放

转换后的.mp3或.flac文件可在手机、电脑、车载音响等各种设备上自由播放，让你随时随地享受音乐。

长期备份保存

摆脱平台依赖，确保珍贵的音乐收藏不会因为服务变更而丢失，为你的音乐保驾护航。

使用技巧与注意事项

高效批量处理

1. 结合脚本自动监控新下载的.ncm文件，及时进行转换。
2. 设置定期批量转换任务，让音乐管理更省心。
3. 使用-r参数保持原有文件夹结构，方便整理转换后的文件。

常见问题解决

• 文件名乱码：确保使用最新版本，已全面支持UTF-8编码。
• 封面缺失：部分新版网易云音乐.ncm文件可能不包含封面图片。
• 编码要求：Windows环境下务必使用UTF-8编码。

进阶开发集成

项目提供完整的动态库支持，开发者可在C#、Python、Java等项目中轻松集成NCM转换功能。参考example目录中的示例代码，快速实现自定义音乐处理应用。

使用ncmdump，你将获得真正的音乐文件所有权、跨平台播放的自由度、长期保存的安心感和个性化管理的便利性。推荐使用最新稳定版本，以获得最佳性能优化、完整字符支持、稳定转换质量和及时的bug修复。现在就开始使用ncmdump，释放被锁定的音乐文件，让你的音乐真正"活"起来！