必须用插件ID（如gruntfuggly.todo-tree）在官方市场下载带版本号的.vsix，校验package.json中engines.vscode字段与本地VSCode版本兼容，安装时用绝对路径加--allow-unverified参数，并同步安装软依赖vscode-icons或改用零依赖的wayou.vscode-todo-highlight。
直接装不成功，大概率是插件没选对或路径写错了——待办事项类插件（比如 gruntfuggly.todo-tree 或 wayou.vscode-todo-highlight）离线安装时，版本兼容性和依赖缺失比普通插件更敏感。
怎么找对那个“待办事项标记管理”插件的 VSIX 文件
VS Code 市场里没有统一叫“待办事项标记管理”的官方插件，实际常用的是两类：
-
gruntfuggly.todo-tree：靠解析// TODO、// FIXME等注释生成侧边树，功能强但依赖vscode-icons（可选）和 Node.js 运行时； -
wayou.vscode-todo-highlight：纯高亮，不建树，零依赖，适合最小化部署。
别搜中文名。打开有网机器的浏览器，访问 https://www.php.cn/link/bb3fa9b98a782af29f14dc2876ca6f65，点右侧 Download Extension 按钮，下载 gruntfuggly.todo-tree-0.0.228.vsix 这类带版本号的文件。注意看 URL 里的 itemName，它就是插件 ID，后面命令行要用。
code --install-extension 安装失败的三个高频原因
即使文件下载对了，code --install-extension 也常静默失败，尤其在内网机器上：
- 路径用了相对路径或含中文/空格：必须用绝对路径，且加英文双引号，例如
code --install-extension "D:/ext/gruntfuggly.todo-tree-0.0.228.vsix"； - VSCode CLI 未注册：在 VSCode 里按
Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH回车启用； - VSCode 正在运行但没焦点：某些 Windows 组策略或远程桌面会拦截 CLI 调用，先手动点开 VSCode 窗口再执行命令。
装上了却看不到 TODO 树？检查 package.json 的 engines 字段
解压你下载的 .vsix 文件（改后缀为 .zip 即可），打开里面的 package.json，找到 "engines": {"vscode": "^1.80.0"} 这一行。运行 code --version，取输出第一位小数点前两位（如 1.85.2 → 1.85），必须 ≥ 插件要求的最低版本。低于这个值，VSCode 会跳过加载，连错误提示都不给。
另外，todo-tree 默认只识别 // TODO，如果你代码里用的是 # TODO 或 /* TODO */，得进设置改 todo-tree.general.tags，否则它“装了等于没装”。
依赖没显式报错，但功能断腿怎么办
比如装了 gruntfuggly.todo-tree 却不显示图标，或搜索无结果——它不强制依赖 vscode-icons，但缺了图标就只剩文字树。这种“软依赖”不会阻断安装，但影响体验。解决方法只有两个：
- 提前把
vscode-icons的 VSIX 也下好，一起用code --install-extension装上； - 或者干脆换用零依赖的
wayou.vscode-todo-highlight，它只做高亮，不建树，适合审计严、环境锁死的场景。
真正麻烦的不是下载或安装，而是插件之间隐性的协作关系——它们不写在 error log 里，只藏在功能是否生效的细节中。
