bookmarks插件离线安装必须用官方市场直链下载的带签名.vsxx文件，通过code --install-extension加--allow-unverified参数安装，路径须为绝对路径且vscode需完全退出后重启；拖拽安装需满足vscode已加载工作区、有焦点、非全屏/远程环境且拖入原始.vsix文件。
Bookmarks 插件离线安装必须用带签名的 .vsix 文件
直接从 GitHub Release 或第三方打包站下载的 Bookmarks.vsix 很大概率无法安装，报 INVALID_SIGNATURE 或静默失败。VSCode 离线环境下不联网验证证书链，但依然会校验文件签名——只有官方市场生成的临时直链才能提供有效签名。
正确做法是：打开插件页 https://www.php.cn/link/d64565c0beb5f0d0d8b6f0aeaef086ed → 右侧 Resources → 点击 Download Extension。浏览器会下载一个带时效签名的 alefragnani.bookmarks-13.0.0.vsix（版本号以实际页面显示为准）。
- 别信“最新版”模糊描述，务必点进
Version History找和你 VSCode 版本匹配的项（如code --version输出1.85.2，就选引擎要求"vscode": "^1.85.0"的版本） - macOS M 系列用户注意文件名是否含
darwin-arm64；若无，可能运行时书签图标不显示或快捷键失效 - 下载后重命名成
bookmarks-13.0.0-darwin-arm64.vsix这类格式，避免后续混淆
code --install-extension 命令加 --allow-unverified 才生效
离线执行 code --install-extension 时，VSCode 默认拒绝未签名或签名不可达的包。即使你下的是官网直链，离线状态也会触发校验失败。
必须显式加上 --allow-unverified 参数：
code --install-extension "/path/to/bookmarks-13.0.0-darwin-arm64.vsix" --allow-unverified
- 路径必须是绝对路径；Windows 推荐用正斜杠：
C:/vsix/bookmarks-13.0.0.vsix - 路径含中文或空格？必须用英文双引号包裹整个路径
- 执行前确认
code命令可用：在 VSCode 中按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH回车启用 - 装完没反应？不是命令失败，而是 VSCode 还在后台运行——右下角托盘图标右键退出，再重试
拖拽安装失败？先检查三个硬性前提
把 .vsix 文件拖进 VSCode 窗口看似简单，但缺一不可：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页不响应拖放
- 窗口必须有系统焦点（任务栏图标高亮），全屏、RDP、TeamViewer 下拖拽被系统拦截
- 拖的是原始
.vsix文件，不是解压后的文件夹，也不是右键重命名生成的bookmarks.vsix.zip（Windows 会静默解压）
验证是否为合法 vsix：unzip -l bookmarks-13.0.0.vsix 应看到顶层目录为 extension/，且含 extension/package.json。
装上了但书签图标不出现？可能是 LSP 或依赖未就绪
Bookmarks 是纯前端插件，不依赖语言服务器，但仍有两个易忽略点：
- 快捷键冲突：默认
Cmd+Option+B（macOS）或Ctrl+Alt+B（Win/Linux）可能被其他插件占用。打开命令面板输入Preferences: Open Keyboard Shortcuts (JSON)，检查是否有重复绑定 - 插件未启用：装完后需重启 VSCode（不是重载窗口），否则侧边栏不渲染书签图标
- 如果用了自定义主题，某些图标颜色可能与背景融合，试试切换回默认主题快速验证
最常被跳过的动作：装完插件后没关掉所有 VSCode 实例，导致扩展缓存未刷新，看起来像“没装上”。
