简介

VFox（Version Fox）是一款跨平台且可扩展的版本管理工具，它采用 Go 语言和 Lua 作为主要编程工具，致力于解决开发者在多环境切换中的痛点39。其设计理念与 nvm、fvm、sdkman 等工具类似，但通过其强大的插件系统扩展了无限可能。

核心功能亮点：

一致性管理：使用统一的命令集管理多种编程语言（如 Node.js, Java, Python, Go, PHP, .NET, Flutter 等）的版本。
项目特定配置与智能切换：支持项目间的不同版本需求，并能自动识别并切换至项目所需的运行时环境，告别手动设置。
强大的插件系统：通过简单的插件添加机制，轻松扩展对更多运行时的支持。它提供了类似于 NPM 或 Scoop 的集中式插件分发入口（全球注册表），方便用户获取插件。
广泛兼容与高效：支持 Windows (非 WSL)、Linux、macOS9，并提供 Bash、ZSH、PowerShell、Clink 等主流 shell 的自动补全功能3。相比同类工具（如 asdf-vm），VFox 在速度上更胜一筹。
开源与社区驱动：VFox 是一个完全开源的项目，目前在 GitHub 上活跃，由社区共同维护和更新。

官网

对比

工具名称	核心支持语言/环境	主要特点	跨平台支持	学习曲线/易用性
VFox	多语言 (Node.js, Java, Python, Go, PHP, Flutter 等)	统一管理、插件系统扩展、项目级自动切换、性能较好	Windows, macOS, Linux	相对较低，命令统一
asdf-vm	多语言 (通过插件支持大量语言和工具)	插件生态丰富、社区强大、依赖管理	macOS, Linux	中等，需管理插件和配置

安装VFox

Github下载对应系统安装包手动安装

windows环境

命令安装


scoop install vfox

或者


winget install vfox

还可以前往 Releases 页面下载最新版本的setup安装器，然后按照安装向导进行安装。

挂载shell

创建 PowerShell 配置:

shell
if (-not (Test-Path -Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }; Add-Content -Path $PROFILE -Value 'Invoke-Expression "$(vfox activate pwsh)"'

如果 PowerShell 提示：在此系统上禁止运行脚本，那么请你以管理员身份重新运行 PowerShell输入如下命令

shell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

之后输入 Y，按回车

移除挂载shell

用记事本打开配置文件：在 PowerShell 或 Windows Terminal 中运行以下命令，这会用记事本打开您的个人配置文件：

powershell
notepad $PROFILE

删除相关行：在打开的记事本窗口中，找到并删除这一行：


Invoke-Expression "$(vfox activate pwsh)"

可能它前后还有其他您自己添加的内容，请只删除这一行，不要误删其他配置。

保存并关闭：直接按 Ctrl + S 保存文件，然后关闭记事本。

mac环境

homebrew
brew install vfox

挂载shell

bash

bash
echo 'eval "$(vfox activate bash)"' >> ~/.bashrc

或者

zsh

zsh
echo 'eval "$(vfox activate zsh)"' >> ~/.zshrc

插件命令


vfox - vfox is a tool for runtime version management.
vfox available      List all available plugins
vfox add [--alias <sdk-name> --source <url/path> ] <plugin-name>  Add a plugin or plugins from official repository or custom source, `--alias` and `--source` are not supported when adding multiple plugins.
vfox remove <sdk-name>          Remove a plugin
vfox update [<sdk-name> | --all] Update a specified or all plugin(s)
vfox info <sdk-name>            Show plugin info
vfox search <sdk-name>          Search available versions of a SDK
vfox install <sdk-name>@<version> Install the specified version of SDK
vfox uninstall <sdk-name>@<version> Uninstall the specified version of SDK
vfox use [--global --project --session] <sdk-name>[@<version>]   Use the specified version of SDK for different scope
vfox list [<sdk-name>]              List all installed versions of SDK
vfox current [<sdk-name>]           Show the current version of SDK
vfox config [<key>] [<value>]       Setup, view config
vfox cd [--plugin] [<sdk-name>]     Launch a shell in the VFOX_HOME, SDK directory, or plugin directory
vfox upgrade                    Upgrade vfox to the latest version 
vfox help                      Show this help message

https://vfox.dev/zh-hans/usage/plugins-commands.html

添加java插件


# 添加插件
vfox add java

# 安装java17
vfox install java@17 

# 使用java17
vfox use -g java@17

添加nodejs插件

查找插件：你可以使用命令来查看所有可用的插件。

添加插件：例如，你需要管理 Node.js，就可以添加 Node.js 插件：


vfox add nodejs

安装特定版本：安装你需要的 Node.js 版本（例如 21.5.0）：


vfox install nodejs@21.5.0

切换到指定版本：在当前目录下使用某个已安装的版本：


vfox use nodejs@21.5.0

这通常会在项目目录下生成一个 .versionrc 文件来记录版本信息。

添加maven插件


# 添加插件
vfox add maven
# 安装 maven3.9.9
vfox install maven@3.9.9
# 使用 maven3.9.9
vfox use -g maven@3.9.9