本文章没有找到对应的语言版本
WINDOWS

博客的置顶文章中前段时间补充了一下 Windows 中最好用的开发环境组合是 wsl + vfox 组合。这篇文章就来简单说说，官方文档很详细，更推荐去看。

下载安装

Vfox Releases 页面下载。如果是绿色版解压安装后需要手动添加到环境变量中。

挂载到 shell

浪子使用的 Git Bash，打开 Git 的安装目录的 xxx/Git/etc/bash.bashrc 文件添加以下内容。如果使用的其它的 Shell，请参考 官方文档

# Uncomment to use the terminal colours set in DIR_COLORS
# eval "$(dircolors -b /etc/DIR_COLORS)"
eval "$(vfox activate bash)"

vfox 的配置和默认存储、缓存路径在 C:\Users\yourname\.version-fox 目录。

升级 vfox 非常简单：

vfox upgrade
# 查看版本
vfox -v

插件和 SDK

插件

vfox 采用插件的方式维护不同工具的版本源，而其本身只实现不同工具版本管理和切换，分工明确，维护便利，有利于第三方工具的集成。

因此 vfox 安装后无法直接使用，需要先安装插件，否则无法使用 search、install 等命令。不过嘛，直接使用 search 时会先提示是否安装插件，如果同意就会自动安装，然后列出版本列表。

# 添加 nodejs 插件
vfox add nodejs
# 搜索 sdk
vfox search nodejs

vfox 支持的插件列表可以使用 vfxo available 查看，也可以查看 官方文档

插件命令

# 显示所有可用的插件
vfxo available
# 显示插件的信息
vfox info [plugin-name]
# 更新某个插件版本
vfox update [plugin-name]
# 更新所有安装的插件版本
vfox update -a

# 移除插件
vfox remove [plugin-name]

SDK

SDK 就是具体版本的运行环境了，当我们安装了插件后，就可以搜索对应的 sdk 并选择版本进行安装了。有关插件和 sdk 以及配置的信息默认都在 C:\Users\yourname\.version-fox 目录中。

SDK 命令

# 查看所有安装的 sdk
vfox list
# 搜索 sdk
vfox search [sdk-name]
# 安装 sdk
vfox i [sdk-name]@[version]
# 卸载 sdk
vfox un [sdk-name]@[version]
# 显示当前使用的 sdk
vfox c [sdk-name]

# 使用指定版本的 sdk
vfox u [sdk-name]@[version]

vfox u 命令有以下选项：

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

vfox 配置

一般来说，vfox 的默认存储路径无需更改，毕竟不是所有的工具都使用特别多不同的版本。当然，vfox 是支持自定义 sdk 的存储路径的。所以我们就修改一下，只让 vfox 的配置和 plugin 等呆在 C:\Users\yourname\.version-fox 目录中，这些占用空间不多。

# 设置 sdk 的安装路径
vfox config storage.sdkPath D:\\software\\dev-tools

# 查看配置
vfox config -l

设置完成之后在安装开发工具都会安装到指定的 storage.sdkPath 目录中。如果 vfox config storage.sdkPath 设置失败，你可以直接打开 C:\Users\yourname\.version-fox\config.yaml 文件添加以下内容：

storage:
    sdkPath: D:\software\dev-tools

然后就可以安装 sdk 了，这里以 java 举例，vfox 支持安装不同平台的 Java，只需要安装时在版本号后添加平台名称即可：

  1. 查看如何安装不同平台的 jdk

vfox-java

  1. 搜索 jdk 版本

vfox1

默认安装的是 open-jdk，如果安装其它平台的 jdk，不要回车，Ctrl + C 退出

  1. 输入命令安装 temurin 平台的 jdk：
vfox i java@25.0.1+8-tem

# 等待安装完毕，使用当前会话检验一下
vfox u -s java@25.0.1+8-tem

# 此时应输出 java version 为 25
java -version

然后重新打开一个 terminal 使用 java -version 命令查看 java 版本应是之前系统默认的版本。

推荐

这样一来，java、python、nodejs 等环境变量不再需要手动添加，使用 vfox 安装后把常用的版本设为全局，其它的版本只在使用的项目中指定，不用工具的版本之间切换使用非常方便。

不过任何事情不是万能的。在使用 IDE 的时候，IDE 本身可能无法识别。此时需要使用 IDE 的相关配置去让它读取到信息。比如 vscode 的 settings.json，再比如在 idea 中手动添加 java 的 sdk 目录等等。

例如本机全局设置 python 3.14，而其它项目中依旧使用旧版本。

# 全局使用 python 3.14
vfox use -g python@3.14

# 其它项目目录中设置旧版本
cd other-py1
vfox use -p python@3.10.0

cd other-py2
vfox use -p python@3.12.0

说些什么吧！

giscus