如何5分钟安装netease-cloud-music-dl：从零基础到下载第一首320k无损音质歌曲的完整入门教程-迪斯科星球

如何5分钟安装netease-cloud-music-dl：从零基础到下载第一首320k无损音质歌曲的完整入门教程

【免费下载链接】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是一款基于 Python 3.x 的网易云音乐命令行下载器，默认下载 320k 高音质 MP3，并自动嵌入专辑封面、写入歌手名 / 歌曲标题 / 专辑名等完整 ID3 元数据。本文是一份面向新手的完整入门教程，只需 5 分钟，从零基础到成功下载第一首歌曲。

🎯 为什么选择 netease-cloud-music-dl？功能亮点一览

功能	说明
🎵 高品质下载	默认 320k 比特率，无 320k 时自动选最高可用比特率
🖼️ 封面嵌入	自动下载专辑封面并写入 MP3 文件内部
🏷️ ID3 元数据	写入歌手名、歌曲标题、专辑名等信息
⏭️ 跳过重复	已下载的音频文件自动跳过，不重复下载
📁 智能分类	支持按歌手 / 专辑自动分文件夹管理
📦 批量下载	支持单曲、多曲、歌手热门、整张专辑、公开歌单、播客/电台

⚠️ 小提示：已下架的音乐暂时无法下载。

元数据写入的核心逻辑在 ncm/file_util.py 中实现（基于 mutagen 库操作 ID3 标签），下载流程见 ncm/downloader.py。

📦 一键安装步骤：只需 3 步

第 1 步：安装 Python 3.x

本工具只支持 Python 3.x。如果电脑尚未安装，请先到 Python 官网下载对应系统的安装包。安装完成后在终端输入python3 --version，能显示版本号即可。

第 2 步：下载源码

打开终端（Windows 用户可用 PowerShell），执行：

git clone https://gitcode.com/gh_mirrors/ne/netease-cloud-music-dl cd netease-cloud-music-dl

第 3 步：执行安装命令

python3 setup.py install

安装过程会自动安装 requirements.txt 中声明的 4 个依赖：requests、pycryptodomex、mutagen、Pillow。当终端最后显示：

Finished processing dependencies for netease-cloud-music-dl==x.x.x

即代表安装成功 🎉 此时命令行中已注册全局命令ncm（入口定义在 setup.py 的console_scripts中，实际入口函数是 ncm/start.py 的main()）。

🎵 下载第一首歌：ncm -s 参数用法

-s后接歌曲 ID或完整歌曲 URL，二选一均可：

ncm -s 123123 # 或 ncm -s http://music.163.com/#/song?id=123123

URL 解析逻辑在 ncm/start.py 中实现。下载完成后，MP3 与封面信息默认保存在用户目录的.ncm/download文件夹中。

📋 ncm 命令速查表：更多下载方式全清单

随时输入ncm -h查看全部参数。常用参数速查如下：

参数	用途	示例
`-s`	下载单曲	`ncm -s 123123`
`-ss`	批量下载多首（ID 用空格分隔）	`ncm -ss 123123 456456`
`-hot`	下载歌手热门单曲（默认 50 首）	`ncm -hot 123123`
`-a`	下载整张专辑	`ncm -a 123123`
`-p`	下载公开歌单全部歌曲	`ncm -p 123123`
`-radio`	下载播客/电台全部节目	`ncm -radio 123123`
`-dj`	下载单个播客节目	`ncm -dj 123123`

💡 注意：-p仅支持公开歌单；批量下载参数均接受 ID 或完整 URL。

⚙️ 进阶配置：ncm.ini 自定义指南

首次运行ncm时会在用户目录自动生成配置文件（macOS/Linux 路径示例：~/.ncm/ncm.ini），由 ncm/config.py 初始化。常用配置项：

[settings] # 歌手热门单曲最大下载数（0 < hot_max <= 50，默认 50） download.hot_max = 50 # 音乐文件保存路径（默认 ~/.ncm/download） download.dir = /Users/yourUserName/.ncm/download # 文件命名格式：1: 歌曲名 | 2: 歌手 - 歌曲名 | 3: 歌曲名 - 歌手 song.name_type = 1 # 智能分类：1: 不分类 | 2: 按歌手分文件夹 | 3: 按歌手/专辑分文件夹 song.folder_type = 1

推荐把song.name_type改为2（歌手 - 歌曲名），并用音乐播放器扫一眼，封面和歌手信息都整整齐齐 ✨

❓ 常见问题 FAQ

Q1：为什么有的歌曲下载失败？提示 "not available due to copyright issue" 表示该歌曲因版权问题不可下载（如已下架音乐），属于正常现象。

Q2：可以只下载低音质省流量吗？目前默认优先 320k 高品质，无 320k 时自动下载最高可用比特率，暂不支持手动指定更低音质。

Q3：Windows / macOS / Linux 都支持吗？支持。三套系统流程完全一致，安装 Python 3 后照本文步骤执行即可。

总结

5 分钟回顾一下完整流程：

安装Python 3.x
git clone下载源码并进入目录
python3 setup.py install完成安装
ncm -s 歌曲ID下载第一首 320k 歌曲 🎉

至此你已经掌握了这款网易云音乐下载器的安装与核心用法，剩下的专辑、歌单批量下载只需替换一下参数即可。更多细节可参考项目自带说明 README.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析