PyNCM安装教程:3分钟快速上手,用一行命令下载你的第一首网易云音乐
【免费下载链接】pyncm第三方网易云音乐 Python API + 转储工具项目地址: https://gitcode.com/gh_mirrors/py/pyncm
PyNCM 是一个开源的第三方网易云音乐 Python API 与下载工具。本PyNCM安装教程将带你用最简单的方式完成环境配置,无需编写复杂代码,只需一行命令即可下载网易云音乐单曲、歌单甚至无损音质歌曲。无论你是编程新手还是老手,都能在 3 分钟内快速上手。
PyNCM 是什么?为什么值得一试?
PyNCM 是「网易云音乐 Python API + 个人音乐库离线转储工具」,它同时提供两套能力:
- 📦Python API 封装:覆盖歌曲、歌单、专辑、歌手、用户、评论等常用接口,供开发者二次调用;
- 🖥️命令行下载工具:直接输入网易云音乐分享链接,就能批量下载歌曲、歌词与封面,还支持无损音质。
更贴心的是,PyNCM 自带匿名登录与多线程下载,开箱即用,无需复杂的逆向知识。
PyNCM安装教程:3分钟快速上手
第一步:检查 Python 环境
PyNCM 要求Python 3.6 及以上版本。在终端(Windows 用 CMD/PowerShell,macOS/Linux 用 Terminal)输入:
python --version看到Python 3.6+即可继续,否则请先到 Python 官网安装最新版。
第二步:一键安装 PyNCM
核心安装只需一条命令:
pip install pyncm等待进度条走完,PyNCM 就安装成功了。如需从源码体验最新功能,也可以克隆仓库后本地安装:
git clone https://gitcode.com/gh_mirrors/py/pyncm cd pyncm && pip install .第三步:安装可选增强组件(推荐)
以下组件不是必须的,但能显著提升体验:
| 组件 | 作用 |
|---|---|
mutagen | 为下载的音乐自动写入歌手、封面等标签信息 |
tqdm | 显示实时下载进度条 |
coloredlogs | 让日志输出带彩色,更易阅读 |
pip install mutagen tqdm coloredlogs第四步:验证安装是否成功
pyncm --help看到参数说明列表,说明安装完成 🎉。
用一行命令下载你的第一首网易云音乐
获取歌曲分享链接
打开网易云音乐 App 或网页版,找到任意歌曲,点击「分享」→「复制链接」,链接形如:
https://music.163.com/song?id=29732235执行一行命令下载
pyncm "https://music.163.com/song?id=29732235"PyNCM 会自动匿名登录、解析链接、下载音频文件并保存到当前目录。这就是「一行命令下载第一首网易云音乐」的完整流程,是不是超级简单?
常用进阶参数
| 参数 | 说明 | 示例 |
|---|---|---|
-o | 指定输出文件夹 | -o ./music |
--quality | 音质:standard / exhigh / lossless / hires | --quality lossless |
-t | 自定义文件名模板(可用{title}、{artists}等) | -t "{track} - {artists}" |
--lyric-no | 控制歌词下载类型 | --lyric-no none下载全部歌词 |
-n | 限制下载数量 | -n 10 |
无损音质下载示例:
pyncm "https://music.163.com/song?id=29732235" --quality lossless -o ./无损进阶玩法:批量下载歌单与专辑
PyNCM 不仅能下载单曲,把分享链接换成歌单、专辑、歌手甚至用户主页的链接,它都会自动识别并批量处理:
# 下载整个歌单 pyncm "https://music.163.com/playlist?id=72897851187" # 下载整张专辑,并限制只下载热度最高的 20 首 pyncm "https://music.163.com/album?id=123456" -n 20 --sort-by hot配合多线程参数-m 8还能同时下载 8 个任务,整张歌单几分钟就能搞定。
登录账号:解锁更高音质
匿名下载一般只能拿到标准音质。想下载无损或 Hi-Res 音质,需要用账号登录,支持手机号、密码、Cookie 三种方式:
pyncm "https://music.163.com/song?id=29732235" --phone 你的手机号 --pwd 你的密码 --quality hires也可以先登录并保存登录态,后续直接复用:
pyncm --phone 你的手机号 --pwd 你的密码 --save ./login.txt pyncm "歌曲链接" --load ./login.txt --quality lossless开发者:3 行 Python 代码调用 API
除了命令行,PyNCM 的 API 封装同样简洁。比如获取歌曲音频地址与详情:
from pyncm import apis print(apis.track.GetTrackAudio(29732235)) # 获取音频 URL print(apis.track.GetTrackDetail(29732235)) # 获取歌曲详情API 模块划分清晰,相关源码位于项目内的pyncm/apis/(如pyncm/apis/track.py、pyncm/apis/login.py),每个函数都有详细注释,十分适合学习与二次开发。
常见问题 FAQ
Q:下载提示获取不到音频 URL?A:先登录再下载。使用pyncm/apis/login.py中提供的LoginViaAnonymousAccount()匿名登录接口即可。
Q:海外用户报错 460「Cheating」?A:在 Session 中添加入口 IP 请求头X-Real-IP = 118.88.88.88即可解决。
Q:下载到一半失败怎么办?A:命令行会输出所有失败的任务 ID,把这些 ID 作为参数重新运行即可续传下载。
结语
通过这篇PyNCM安装教程,你已经掌握了从环境准备到一行命令下载网易云音乐、批量下载歌单、解锁无损音质以及调用 Python API 的全流程。工具虽小,功能齐全——快去试试下载你的第一首心仪歌曲吧!🎵
【免费下载链接】pyncm第三方网易云音乐 Python API + 转储工具项目地址: https://gitcode.com/gh_mirrors/py/pyncm
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考