vfox使用指南

vfox使用指南

vfox是一个版本管理工具，可以方便的管理各种开发环境的版本，比如go、python、nodejs。

vfox当前支持如下开发环境的sdk版本管理：

C:\Users\growd>vfox available
NAME                             VERSION         AUTHOR                  DESCRIPTION
dart/dart                        0.0.1           Aooohan                 dart plugin, support for getting stable, dev, beta version
deno/deno                        0.0.1           Aooohan                 Deno plugin, https://deno.com/
dotnet/dotnet                    0.0.1           Korbinian Habereder     dotnet plugin, support for dotnet sdks 6.0, 7.0, 8.0
flutter/flutter-cn               0.0.1           Aooohan                 flutter plugin for China, support for getting stable, dev, beta version
flutter/flutter                  0.0.2           Aooohan                 flutter plugin, support for getting stable, dev, beta version
golang/golang                    0.0.2           Aooohan                 -
gradle/gradle                    0.0.1           ahai                    gradle
java/adoptium-jdk                0.0.2           aooohan                 Adoptium JDK
java/azul-adoptium-jdk           0.0.2           axdank                  Azul (Zulu) JDK - Adoptium
java/azul-jdk                    0.0.4           yimiaoxiehou            Azul JDK, also known as Zulu
java/graalvm                     0.0.2           ahai                    graalvm JDK
java/ibm-adoptium-jdk            0.0.2           axdank                  IBM JDK - Adoptium
java/microsoft-adoptium-jdk      0.0.2           axdank                  Microsoft JDK - Adoptium
java/redhat-adoptium-jdk         0.0.2           axdank                  RedHat JDK - Adoptium
kotlin/kotlin                    0.0.21.9.0      Aooohan                 Kotlin plugin
maven/maven                      0.0.2           Aooohan                 -
nodejs/nodejs                    0.0.7           Aooohan                 Node.js
nodejs/npmmirror                 0.0.5           yimiaoxiehou            install Node.js use https://cdn.npmmirror.com
python/npmmirror                 0.0.3           aooohan                 vfox >= 0.2.3 !!! From npmmirror.org. For Windows, only support >=3.5.0, but no restrictions for uni...
python/python                    0.0.3           aooohan                 vfox >= 0.2.3 !! For Windows, only support >=3.5.0, but no restrictions for unix-like
zig/zig                          0.0.4           aooohan                 Zig

vfox采用插件机制，每一种sdk开发环境对应一个插件，在使用前我们需要先安装对应的sdk插件。

安装插件

vfox add plugin_name

这里的plugin_name就是上面使用vfox available显示出来的NAME那一列。

比如安装golang插件，

C:\Users\growd>vfox add golang/golang 
Loading plugin from https://version-fox.github.io/version-fox-plugins/golang/golang.lua...
Checking plugin...
Plugin info:
Name    -> golang
Author  -> Aooohan
Version -> 0.0.2
Desc    ->
Path    -> C:\Users\growd\.version-fox\plugin\golang\main.lua
Add golang plugin successfully! 
Please use `vfox install golang@<version>` to install the version you need.

安装sdk版本

插件安装好后，就可以安装对应的sdk，vfox主要是用来做版本管理的，所以在下载时需要制定版本。如果不知道版本号，可以到对应的官方网站上查看，当然也可以使用latest，但不是所有的sdk都支持这个版本号。

使用如下命令添加对应版本的sdk。

vfox install sdk@version

比如下载go的最新版本：

vfox install golang@latest

命令执行结果如下：

C:\Users\growd>vfox install golang@latest
Preinstalling golang@1.22.1...
Downloading... 100% [===============================================================================================================================================================================================================================================] (20 MB/s)        
Verifying checksum cf9c66a208a106402a527f5b956269ca506cfe535fc388e828d249ea88ed28ba...
Unpacking C:\Users\growd\.version-fox\cache\golang\go1.22.1.windows-amd64.zip...
Install golang@1.22.1 success! 
Please use vfox use golang@1.22.1 to use it.

使用指定版本的sdk（切换版本）

安装了sdk后，还需要指明要使用哪个版本的sdk，或者在遇到需要切换版本时，需要切换到不同的版本。这个时候要使用到vfox use命令，命令使用方式如下：

C:\Users\growd>vfox use --help
NAME:
   vfox use - use a version of sdk

USAGE:
   vfox use [command options] [arguments...]

OPTIONS:
   --global, -g   used with the global environment (default: false)
   --project, -p  used with the current directory (default: false)
   --session, -s  used with the current shell session (default: false)
   --help, -h     show help

可以看到vfox有三个级别，全局、项目级、当前shell，分别使用-g -p -s这三个参数来指定。比如指定golang1.22.1为全局使用，则使用如下命令：

vfox use -g golang@1.22.1

执行结果如下：

C:\Users\growd>go  
'go' 不是内部或外部命令，也不是可运行的程序
或批处理文件。

C:\Users\growd>vfox use -g golang@1.22.1
Warning: The current shell lacks hook support or configuration. It has switched to global scope automatically.
Now using golang@1.22.1.
Microsoft Windows [版本 10.0.19045.4046]
(c) Microsoft Corporation。保留所有权利。
C:\Users\growd>go version
go version go1.22.1 windows/amd64

此时就可以使用go进行开发了。

安装deno

vfox add deno/deno
vfox install deno@1.41.2
vfox use deno@1.41.2 -g