优先选vsc netease music（vs code 1.85+），旧版或linux/macos用户选cloudmusic-vscode；播放失败主因是libffmpeg缺失或版本不匹配，需手动补全对应平台的音频解码库。
Cloudmusic-VSCode 和 VSC Netease Music 是目前能在 VS Code 里直接听网易云音乐的两个主流插件。它们功能重叠度高，但底层实现和兼容性差异明显——**如果你用的是 VS Code 1.85+（2024 年底起默认集成 ffmpeg 的 Electron 25+），优先选 VSC Netease Music；若你频繁更新 VS Code 或用 Linux/macOS 旧版本，Cloudmusic-VSCode 更稳定，但需手动处理音频解码依赖**。
为什么装了插件却点不动播放？
最常见原因是 Electron 内置的 libffmpeg.so（Linux/macOS）或 ffmpeg.dll（Windows）缺失或版本不匹配，导致 Web Audio API 初始化失败。错误提示常为：Please interact with the document first otherwise play() will failed 或控制台报 DOMException: The element has no supported sources。
解决方法不是重装插件，而是补全音频后端：
- Windows：VS Code 1.31+ 已自带完整 ffmpeg，无需操作；若仍异常，检查是否被杀毒软件拦截了
Code.exe的网络/音频访问权限 - macOS：下载对应 Electron 版本的
electron-*.darwin-x64.zip，解压后替换Visual Studio Code.app/Contents/Frameworks/Electron Framework.framework/Libraries/libffmpeg.dylib - Linux：找到 VS Code 安装目录下的
libffmpeg.so（通常在/usr/share/code/libffmpeg.so或~/.vscode/extensions/xxx/libffmpeg.so），用 Electron 官方包里的同名文件覆盖
注意：每次 VS Code 自动升级后，Linux/macOS 用户大概率要重做一次替换。
VSC Netease Music 快速登录与状态栏控制
它用 Webview + Web Audio 实现播放，不依赖系统命令行播放器，响应快、界面轻量。登录后状态栏会立刻出现播放控件，但默认是「紧凑模式」——只显示播放/暂停按钮和当前歌名缩略。
想展开完整面板，只需点击状态栏上的音乐图标；常用快捷键也直接生效：
-
Alt + M：静音/恢复 -
Alt + ,：上一首 -
Alt + .：下一首 -
Alt + /：播放/暂停
如果快捷键失效，检查是否与其他插件（如 Vim 模式、Emacs 键映射）冲突；可在 Settings → Keyboard Shortcuts 中搜索 neteasemusic 重新绑定。
Cloudmusic-VSCode 的本地音乐支持与队列管理
这个插件更侧重工程化设计，比如它的播放队列逻辑实现在 packages/client/src/treeview/queue.ts，支持拖拽排序、按来源（歌单/搜索/本地）分组，适合需要精细控制播放流的用户。
本地音乐功能由 packages/client/src/activate/local.ts 驱动，能扫描指定文件夹（如 ~/Music），自动识别 MP3/WAV/FLAC 文件并加入播放列表——但注意：它不会自动转码，若遇到编码异常的 FLAC 文件，可能静音或跳过。
另外，它的歌词同步依赖网易云 API 返回的 lrc 内容，部分冷门歌曲或自制翻唱可能无歌词；此时可手动拖入本地 .lrc 文件到当前播放项，插件会尝试时间轴对齐。
Electron 版本和音频解码是隐藏门槛
很多用户卡在“登录成功但无法播放”，反复重装插件、换账号、清缓存，其实问题根本不在插件本身，而在 VS Code 底层是否具备音频解码能力。2026 年当前最新版 VS Code（1.90+）虽已升级到 Electron 31，但部分 Linux 发行版打包时仍剥离了 ffmpeg（如某些 Arch AUR 包、Debian stable 源）。这时候即使插件最新，也得自己补 libffmpeg ——别跳过这步，它比调配置重要得多。
