PyNCM安装教程:3分钟快速上手,用一行命令下载你的第一首网易云音乐
2026/8/21 18:01:10 网站建设 项目流程

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.pypyncm/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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询