核心命令

Search

获取指定 SDK 所有可用的运行时版本。

用法

vfox search <sdk-name> [...optionArgs]

sdk-name: 运行时名称， 如nodejs、custom-node。 optionArgs: 搜索命令的附加参数。注意：是否支持取决于插件。

缓存

vfox会缓存search的结果, 默认缓存时间为12h。

如果你想禁用，可以通过vfox config命令进行配置。

vfox config cache.availableHookDuration 0

其余操作, 请查看配置#缓存。

快捷安装

选择目标版本， 回车即可快速安装。

自动安装

如果本地没有安装 SDK，search命令会从远端仓库检索插件并安装到本地。

Install

将指定的 SDK 版本安装到您的计算机并缓存以供将来使用。

用法

vfox install <sdk-name>@<version>

vfox i <sdk-name>@<version>

sdk-name: SDK 名称

version: 需要安装的版本号

选项

• -a, --all: 安装 .tool-versions 中记录的所有 SDK 版本
• -y, --yes: 直接安装，跳过确认提示

自动安装

你可以一次性安装多个 SDK，通过空格分隔。

vfox install nodejs@20 golang ...

TIP

直接安装，跳过确认提示

vfox install --yes nodejs@20
vfox install --yes --all

Use

设置运行时版本

用法

vfox use [options] <sdk-name>[@<version>]

vfox u [options] <sdk-name>[@<version>]

sdk-name: SDK 名称

version[可选]: 使用 指定版本运行时。如不传， 则下拉选择。

选项

• -g, --global: 全局生效
• -p, --project: 当前目录下生效
• -s, --session: 当前 Shell 会话内生效

默认作用域

Windows: 默认Global作用域

Unix-like: 默认Session作用域

Unuse >= 0.9.0

从指定作用域取消设置运行时版本

用法

vfox unuse [options] <sdk-name>

sdk-name: SDK 名称

选项

• -g, --global: 从全局作用域移除
• -p, --project: 从项目作用域移除（当前目录）
• -s, --session: 从会话作用域移除（当前 Shell 会话）

默认作用域

Windows: 默认Global作用域

Unix-like: 默认Session作用域

效果

使用 unuse 后，SDK 将不再在指定作用域中处于活动状态。如果 SDK 在其他作用域中配置，那些将根据 vfox 的作用域层次结构优先生效（Session > Project > Global）。

Uninstall

卸载指定版本的 SDK。

用法

vfox uninstall <sdk-name>@<version>
vfox un <sdk-name>@<version>

sdk-name: SDK 名

version: 具体版本号

List

查看当前已安装的所有 SDK 版本。

用法

vfox list [<sdk-name>]

vfox ls[<sdk-name>]

sdk-name: SDK 名称， 不传展示所有。

Current

查看当前 SDK 的版本。

用法

vfox current [<sdk-name>]
vfox c

Cd

在 VFOX_HOME 或 SDK 目录下启动 shell。

用法

vfox cd [options] [<sdk-name>]

sdk-name: SDK 名称, 不传默认为 VFOX_HOME。

选项

• -p, --plugin: 在插件目录下启动 shell。

Upgrade >= 0.4.2

升级 vfox 到最新版本。

用法

vfox upgrade