命令混淆：omp install 与 omp plugin install

你会遇到什么

按网上教程执行 omp install <插件名> 失败或行为不符预期；正确姿势是 omp plugin install <插件名>。教程和实际命令对不上。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

npm 页面曾给出错误指令 omp install（来源：issue #36）。在 18.0.9 中 omp install 已被实现为 omp plugin install 的别名（帮助文本明示 alias of plugin install/plugin link），但旧文档/旧教程仍以错误姿势传播，新旧混用造成混淆。

这是 CLI 命令面演进留下的"文档化石"：早期版本把安装命令设计成 omp install（issue #36 指出 npm 页面就这么写的），后来命令面改版成 plugin 子命令体系，为了不破坏老用户的肌肉记忆，把 omp install 保留成了别名。问题出在教程的传播滞后——写教程的人用的是旧版本，教程比命令面老，于是网上新旧两种姿势并存。

omp --help 是命令面的真相源：它列出的子命令和别名标注（alias of plugin install/plugin link）是当前版本实打实的行为，比任何教程都新。

一步步来

1. 显式使用 omp plugin install — 必做

omp plugin install <name>

2. 不确定时先自查 — 必做

omp --help

install / plugin 子命令均会列出（实测：install 标注 alias of plugin install/plugin link）。

怎么确认修好了

帮助文本与命令行为正确（实测输出形态）：

omp --help → 同时含 install（alias of plugin install/plugin link）与 plugin 子命令（实测）
omp plugin install <name> → 正常安装

其它环境的表现

症状

用户按网上教程执行 omp install <插件名> 失败或行为不符预期；正确姿势是 omp plugin install <插件名>。

原因

npm 页面曾给出错误指令 omp install（来源：issue #36）；在 18.0.9 中 omp install 已被实现为 omp plugin install 的别名（帮助文本明示 alias of plugin install/plugin link），但旧文档/旧教程仍以错误姿势传播，新旧混用造成混淆。

解法

1. 显式使用 omp plugin install <name>（最不易歧义）。
2. 不确定时先 omp --help 自查子命令（install / plugin 均会列出）。