应依次执行重置配置文件、禁用冲突插件、手动刷新主页与工具箱三步操作:先用Marquee: Open Configuration File恢复默认marquee.json,再禁用Custom CSS、One Dark Pro等可能劫持WebView的插件,最后运行Marquee: Refresh Homepage和Marquee: Reload Toolbox Items完成修复。

如果您在 Visual Studio Code 中安装了 Marquee 插件,但发现其主页未正常显示、滚动信息缺失或效率工具箱功能无法响应,则可能是由于插件配置未生效、核心依赖未加载或工作区权限限制所致。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、重置 Marquee 插件配置文件
Marquee 插件依赖用户级 JSON 配置文件(marquee.json)控制主页内容与工具箱行为。该文件若被意外修改或格式损坏,将导致主页空白或工具项失效。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Marquee: Open Configuration File 命令。
3、在打开的 marquee.json 文件中,全选内容并删除,粘贴默认配置模板:
{ "homepage": { "enabled": true }, "toolbox": { "items": [] } }
4、保存文件并关闭编辑器,重新启动 VSCode。
二、禁用冲突插件并验证加载顺序
Marquee 主页采用 Webview 渲染机制,部分插件(如某些主题扩展或全局状态覆盖工具)会劫持 WebView 初始化流程,造成主页白屏或工具箱按钮无响应。
1、按下 Cmd + Shift + P 打开命令面板。
2、执行 Extensions: Show Enabled Extensions 命令。
3、逐个禁用以下类型插件:Custom CSS and JS Loader、One Dark Pro、GitLens(启用 GitLens WebView 选项时)、Bracket Pair Colorizer。
4、每次禁用后重启 VSCode,检查 Marquee 主页是否恢复渲染。
三、手动触发主页重建与工具箱刷新
Marquee 插件在首次加载后会缓存主页 DOM 结构与工具箱元数据。当项目结构变更或插件更新后,缓存可能未同步,导致主页信息陈旧或工具项不可见。
1、确保当前工作区已打开一个文件夹(非空窗口)。
2、按下 Cmd + Shift + P 打开命令面板。
3、输入并选择 Marquee: Refresh Homepage 命令。
4、等待右下角出现 Homepage rebuilt successfully 提示。
5、再次执行 Marquee: Reload Toolbox Items 命令。










