foobox-cn 安装教程：3 步完成 foobar2000 主题与布局配置（附故障排查表）
【免费下载链接】foobox-cnDUI 配置 for foobar2000项目地址: https://gitcode.com/GitHub_Trending/fo/foobox-cn
foobox-cn 安装过程只需几分钟，本文带你走完装前自检、部署、切换布局到调面板的完整流程。foobox-cn 是为 foobar2000 制作的 DUI 皮肤配置，基于 JSplitter（界面分栏框架）重写布局，把窗口分成左侧导航区、中央播放列表区和底部控制区，附带搜索框、流派图标筛选和艺术家简介面板。
⚙️ 装前 3 项环境自检
这一步解决"装不上、装了报错"的问题。对照下表逐项确认，任何一项不满足都会导致组件加载失败或界面异常。
| 检查项 | 要求 |
|---|---|
| 操作系统 | Windows 10 1607 或更高版本 |
| 播放器 | foobar2000 中文汉化版（基于 Asion 汉化版制作，菜单文字与汉化版对应） |
| 版本与位数 | 32 位（x86）需 v1.5+；64 位（x64）需 v2.0+，位数必须与已装播放器一致 |
位数是最常见的翻车点：32 位播放器装 64 位安装包，组件会直接加载失败。确认无误后，到项目 Releases（发行版）页面下载对应位数的最新安装包。安装包是绿色免安装形式，不含 foobar2000 汉化版本身，只含主题脚本和组件。若需要视频面板，可另下 foobox-video，但作者并不推荐用 foobar2000 播放视频。
皮肤依赖的 4 个第三方组件，安装时会一并写入你的 foobar2000 目录：
| 组件 | 作用 |
|---|---|
| JSplitter | 界面分栏与面板框架 |
| openhacks_mod | 扩展脚本能力 |
| ESLyric | 歌词显示 |
| foo_enhanced_spectrum_analyzer | 频谱分析 |
🔧 4 步完成安装
这一步解决"怎么装、装到哪"的问题。
- 运行安装包，安装程序自动检测 foobar2000 安装路径；
- 检测不到或想换目录时，点击 浏览(B)...，选择 foobar2000.exe 所在文件夹；
- 按提示完成安装，重启 foobar2000；
- 打开主菜单 → 视图 → 布局 → 快速设置，选一种 foobox 布局组合，界面立即切换为新皮肤。
安装完成后，配置目录中会多出一个foobox文件夹（脚本与图片资源）及各组件的 .dll、.cfg 文件。日后备份或换机恢复，只复制这部分内容到新机器同位置覆盖即可。
🎨 明暗主题与布局模板怎么选
这一步解决"界面看起来不像主流音乐软件"的问题——配色和布局都在同一个入口切换，不用改任何脚本。
两套主题的适用场景
foobox-cn 内置浅色、深色两套配色，通过主菜单 → 视图 → 布局 → 快速设置选择对应组合即可切换：
- 浅色主题：柔和绿色主色调，白底深灰文字，适合白天；
- 深色主题：深灰/黑色背景配蓝色高亮，适合夜间长时间使用。
布局模板速查
| 布局 | 特点 | 适合场景 |
|---|---|---|
| 标准布局 | 带艺术家简介面板 | 日常使用 |
| 多列表布局 | 中央区显示多个播放列表 | 批量管理歌曲 |
| 简洁布局 | 去掉附加面板，只保留核心功能 | 低配机器或嫌界面杂 |
| 视频布局 | 需另装 foobox-video | 在线视频场景 |
建议先用默认布局一两天，摸清各面板位置后再切换，避免在陌生布局里找功能入口。
🗂️ 播放列表、搜索框与流派筛选怎么调
这一步解决"日常操作不够顺手"的问题。三个高频功能都有独立脚本，普通用户保持默认即可，需要微调时按路径对号入座。
多播放列表切换
中央播放列表区可同时维护多个列表，用标题栏标签快速切换，也可滚动纵向列表选择。列表行为（行高、滚动步进、网格显示、触摸控制）由script/js_panels/jsview_multiplaylist.js控制，出现卡顿或显示异常时再考虑动它。
搜索框快速查找
内置搜索框支持在当前列表或全盘范围内查找歌曲，可配置的项：搜索范围、是否自动校验输入、匹配结果加入新列表还是替换原列表、是否跟随光标显示。选项定义在script/js_panels/search.js中，一般通过面板右键属性菜单修改。
流派图标筛选
Genre/目录自带 26 张流派图标，涵盖 Pop、CPop、JPop、KPop、Rock、Metal、Jazz、EDM、Blues、ACG、Classical 等分类。歌曲的流派标签自动映射到图标，映射表在script/js_common/Genre.js：例如"华语流行""C-POP"都归入 CPop，"说唱"归 Rap、"嘻哈"归 Hip-Hop。遇到未收录的流派名，直接在映射表里补一行即可。
艺术家简介面板
简介面板基于 Biography 插件，显示当前艺术家/专辑的照片、文字简介、热门专辑和相似艺术家，脚本与资源都在biography/目录。面板支持上、下、左、右及叠加等位置预设，切换同样走布局快速设置。网络环境不佳时可关闭自动加载，改为手动刷新。
🩺 故障快速排查表
这一步解决"装完不对"的问题。按现象对照处理，多数情况前两步就能解决。
| 现象 | 排查步骤 |
|---|---|
| 安装后仍是旧界面 | 确认位数与播放器对应；重启 foobar2000；重新进主菜单 → 视图 → 布局选 foobox 布局 |
| 界面显示异常、面板错位 | 核对位数与版本要求；删除配置目录缓存后重启；仍异常则卸载重装最新版 |
| 歌词不显示 | 确认 ESLyric 已随安装包写入；确认歌词源网络可达 |
| 组件加载报错 | 逐一核对 JSplitter、openhacks_mod 等 .dll 是否安装成功，位数是否与播放器一致 |
| 换机后恢复配置 | 复制配置目录中的foobox文件夹及各组件 .cfg 文件到新机器同位置覆盖 |
以上均无效时，对照发行版说明附带的帮助文档核对组件清单，逐个比对本地文件是否齐全。
装好后把常用布局固定下来，顺手调一下搜索范围、多列表保留行为这类高频选项，再逐步试主题和简介面板的位置预设。日常所有调整都从主菜单 → 视图 → 布局入口操作；脚本目录（foobox/script/、script/js_common/、script/js_panels/）只在深度定制时才动，改前先复制一份备份。
【免费下载链接】foobox-cnDUI 配置 for foobar2000项目地址: https://gitcode.com/GitHub_Trending/fo/foobox-cn
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
