本地音乐播放器
在 VS Code 中播放和管理本地音乐。
快速开始
- 打开活动栏中的“本地音乐”。
- 点击音乐库标题栏的“设置播放目录”，选择音乐目录。
- 在音乐库中双击歌曲播放；单击歌曲只进行选择。
音乐库支持歌曲搜索、筛选、排序、按目录浏览和歌单管理。可使用 Ctrl/Shift 多选歌曲，然后批量添加到歌单或从歌单移除。播放中会显示正在播放面板和状态栏提示；多个 VS Code 窗口共享同一播放状态。
面板
正在播放
显示封面、歌曲信息、歌单、歌词和播放进度。可执行播放/暂停、上一首、下一首、切换播放模式、添加到歌单和定位文件。
播放模式有三种：
- 列表循环：按列表顺序播放，到末尾后回到开头。
- 随机循环：随机播放，尽量避免连续播放同一首。
- 单曲循环：当前歌曲结束后重新播放。
音乐库
音乐库只负责目录、歌曲和歌单操作。歌曲右键菜单支持播放、添加到歌单、移除和定位文件；歌单右键菜单支持播放、重命名和删除。
设置
设置入口：文件 > 首选项 > 设置，搜索 Local Music。
音乐库
| 设置 |
默认值 |
说明 |
playDirectory |
空 |
音乐库根目录。为空时不扫描。 |
extensions |
常见音频格式 |
扫描的扩展名，不含 .。 |
groupByDirectory |
true |
在所有歌曲视图中按文件夹层级显示歌曲。 |
sortBy |
title |
歌曲列表排序：歌曲名、歌手、专辑、路径或修改时间。 |
歌词
| 设置 |
默认值 |
说明 |
lyricsPriority |
embeddedFirst |
选择优先使用内嵌歌词还是同名 .lrc 文件。 |
播放
| 设置 |
默认值 |
说明 |
playMode |
listLoop |
列表循环、随机循环或单曲循环。 |
volume |
0.8 |
播放音量，范围 0 到 1。 |
autoRestore |
true |
启动时恢复上次歌曲、队列和位置，但不会自动播放。 |
播放设备
| 设置 |
默认值 |
说明 |
stopOnDeviceChange |
false |
普通播放设备切换或断开时是否停止。 |
stopOnHeadphoneDisconnect |
true |
耳机类设备断开时是否停止。 |
resumeOnHeadphoneReconnect |
true |
耳机重新连接并成为默认设备后是否恢复播放。 |
支持格式
默认扫描：mp3、flac、m4a、wav、ogg、opus、aac、wma、ape、wv、mp4。
实际播放能力取决于音频后端；部分格式可能可以扫描标签，但无法播放。
开发
开发架构、代码约束、构建验证和发布流程见 AGENTS.md。
| |
