上来就对标 20k Star 的开源项目,是自不量力还是后起之秀?
共 20204字,需浏览 41分钟
·
2024-04-11 10:31
先来一段紧箍咒:nvm、fvm、gvm、sdkman、fnm、n、g、rvm、jenv、phpbrew、rustup、swiftenv、pyenv、rbenv...
![f4d4f084266e2d7aa7099fe6fb31a0a6.webp](https://filescdn.proginn.com/96e8217bf5f0626f15c41466c4e64d94/f4d4f084266e2d7aa7099fe6fb31a0a6.webp)
这些都是用来解决编程语言多版本管理的工具,如果你是个程序员肯定认识或是用过几个,但是刚接触编程的小白,就会有些挠头了。
啥是编程语言版本管理工具?它们有什么用呢?
举个例子,用 Java 的开发者可能会遇见的问题,公司的项目是万年不变 JDK 8,但个人项目用的是最新的 JDK 21。这种情况下,在一台电脑上开发公司和个人项目的时候,就需要切换一下当前开发环境对应的 JDK 版本,否则项目跑不起来。编程语言版本管理工具就是用来切换/管理编程语言不同版本的工具,比如 Java 语言对应的工具是 jenv
。
每一种编程语言都有一个对应的版本管理工具,对于多语言开发者来说就需要安装、配置、学习各种版本管理工具,记忆不同工具的使用命令,这和紧箍咒无异。那咋办啊?
![3090d9ca6bfc0896abd2d4919ac98774.webp](https://filescdn.proginn.com/a5ea51e0c1fdb359f981c6ed91de40f0/3090d9ca6bfc0896abd2d4919ac98774.webp)
莫慌,今天 HelloGitHub 带来的是一款跨平台版本、支持多语言的版本管理工具——vfox,让你无忧应对多编程语言、不同版本的开发环境。该项目由国人(99 年的小伙)开发,更贴合国内开发者的使用习惯。
![a2b71fd21cd0d931f04061f1e742b38b.webp](https://filescdn.proginn.com/dde0f7662cf5b18448f910afcd685f6d/a2b71fd21cd0d931f04061f1e742b38b.webp)
GitHub 地址:https://github.com/version-fox/vfox
接下来,让我们一起走近 vfox 了解它的功能、上手使用、技术原理和强大的插件系统吧!
一、介绍
vfox 是一个类 nvm、fvm、sdkman、asdf 的版本管理工具,具有跨平台、通用、易拓展的特性:
- 简单:安装简单,一套命令管理所有语言
- 跨平台:支持 Windows、Linux、macOS
- 人性化:换项目时自动切换到对应编程语言、支持自动补全
- 扩展性:容易上手的插件系统,添加冷门的编程语言
- 作用域:支持 Global、Project、Session 三种作用域
质疑声:同类型的项目挺多的啊,不能一个国人开发、开源就来求 Star 吧?
下面,我们就来和在 GitHub 上有 20k Star 的同类型工具 asdf PK 一下,看看 vfox 是不是重复造轮子,到底能不能打!
二、对比 asdf
这里主要从操作系统兼容性、性能和插件换源三个方面进行对比。
2.1 兼容性
兼容性 | Windows | Linux | macOS |
---|---|---|---|
asdf | ❌ | ✅ | ✅ |
vfox | ✅ | ✅ | ✅ |
首先,asdf 是用 shell 脚本实现的工具,所以并不支持原生 Windows 环境。而 vfox 是用 Go + Lua 实现的,因此天生支持 Windows 和其他操作系统。
2.2 性能
![f441054d8a91618631822ff8541af38e.webp](https://filescdn.proginn.com/f9ec89522da605c59f29fae43e97d96b/f441054d8a91618631822ff8541af38e.webp)
上图是对两个工具最核心的切换版本功能进行基准测试的结果,很容易就能得出结论:vfox 比 asdf 快 5 倍。
速度 | 平均 | 最快 | 最慢 |
---|---|---|---|
asdf | 158.7 ms | 154 ms | 168.4 ms |
vfox | 28.1ms | 27.1 ms | 32.3 ms |
技术解析:asdf 执行切换版本的速度之所以较慢,主要是由于其垫片机制。简单来说,当你尝试运行如 node 这样的命令时,asdf 会首先查找对应的垫片,然后根据 .tool-versions
文件或全局设置来确定使用哪个版本的 node 。这个查找和确定版本的过程会消耗一定的时间,从而影响了命令的执行速度。
相比之下,vfox 则采用了直接操作环境变量的方式来管理版本,它会直接设置和切换环境变量,从而避免了查找和确定版本的过程。因此,在执行速度上要比使用垫片机制的 asdf 快得多。
虽然 asdf 很强,但是它对 Windows 原生无能为力。虽然 vfox 很新,但在性能和跨平台方面做得更好。
2.3 插件换源
大多数时候,我们会被网络问题而困扰,所以切换下载源的操作是必不可少的。
下面以切换 Node.js 源为例,对比 asdf 和 vfox 在换源时的区别。
asdf 是通过 asdf-vm/asdf-nodejs
插件实现了对于 Node.js 的支持,但该插件是需要手动预定义一个环境变量来修改下载源,多语言换源还需要设置多个不同的环境变量。
- 优点:可以灵活切换任何镜像源
- 缺点:需要手动设置,操作不友好
vfox 选择了另一种方法,即一个镜像源对应一个插件。
$ vfox add nodejs/nodejs # 使用官方下载源
$ vfox add nodejs/npmmirror # 使用 npmmirror 镜像
$ vfox add python/python # 官方下载源
$ vfox add python/npmmirror
虽然这样会使仓库的插件变多,但使用起来降低了负担,也没有乱七八糟的环境变量需要配置,对用户非常友好!
三、上手
说了这么多,还没上手玩一下简直忍不了。
3.1. 安装
Windows 用户只需要下载安装器进行安装即可,Linux 用户可以使用 APT 或 YUM 来快速安装,macOS 用户可以使用 Homebrew 安装。更详细的安装方式可查看文档
$ brew tap version-fox/tap
$ brew install vfox
安装完成之后,需要将 vfox 挂载到你的 shell 中,从下面条目中选择一条适合你 shell 的。
echo 'eval "$(vfox activate bash)"' >> ~/.bashrc
echo 'eval "$(vfox activate zsh)"' >> ~/.zshrc
echo 'vfox activate fish | source' >> ~/.config/fish/config.fish
# 对于 Powershell 用户,将下面行添加到你的 $PROFILE 文件中
Invoke-Expression "$(vfox activate pwsh)"
3.2 使用
安装好了,但你还做不了任何事情,因为 vfox 是使用插件作为扩展,按需安装。
不知道应该添加哪些插件,可以用
vfox available
命令查看所有可用插件
所以你还需要安装插件,以 Node.js 为例,为了获得更好的体验,我们添加 npmmirror 镜像源插件:vfox add nodejs/npmmirror
。
![1d8734a7ccf012ae676b3abbf6f37c98.webp](https://filescdn.proginn.com/10451e4a3f9197dc86a8f8f9d9b2385d/1d8734a7ccf012ae676b3abbf6f37c98.webp)
在插件成功安装之后,你就可以玩起来了!
- 安装指定版本:
vfox install nodejs@<version>
- 安装最新版本:
vfox install nodejs@latest
- 切换版本:
vfox use nodejs[@<version>]
文字表达远不如图片来的更直观,我们直接上效果图。
![3e65a860361dd5c9653be39a520fc733.webp](https://filescdn.proginn.com/e6cca4b85aafb772e4d923cd97a5dc74/3e65a860361dd5c9653be39a520fc733.webp)
四、技术原理
vfox 支持 Global、Session、Project 三种作用域,这三种作用域能够满足我们日常开发所需的场景。
作用域 | 命令 | 说明 |
---|---|---|
Global | vfox use -g <sdk-name> |
全局范围有效 |
Session | vfox use -s <sdk-name> |
当前 shell 会话有效 |
Project | vfox use -p <sdk-name> |
当前项目下有效 |
那么你对它们的实现原理感兴趣吗?咱们废话不多说,直接看原理图!
![81a7cbfffb0403b5c83e9c4f2fb10515.webp](https://filescdn.proginn.com/c3449956be8ae832e17e5f022f9be9c4/81a7cbfffb0403b5c83e9c4f2fb10515.webp)
vfox 是基于 shell 的 hook 机制实现的,hook 机制简单来说就是每当我们执行完命令之后,shell 都会调用一下你配置的钩子函数(hook),即 vfox env <shell-name>
命令,我们后面解释这个命令是干什么的。
说回到作用域上来,vofox 是通过 .tool-versions
文件来记录每个 SDK 对应的版本号信息。对于三种作用域,会分别在不同的地方创建 .tool-versions
文件,用于记录作用域内所需要的 SDK 版本信息。
-
Global
->$HOME/.version-fox/.tool-versions
-
Project
->当前项目目录
-
Session
->$HOME/.version-fox/tmp/<shell-pid>/.tool-versions
代码如下:
func newSdkManagerWithSource(sources ...RecordSource) *Manager {
meta, err := newPathMeta()
if err != nil {
panic("Init path meta error")
}
var paths []string
for _, source := range sources {
// 根据不同的作用域选择性加载不同位置的.tool-versions文件
switch source {
case GlobalRecordSource:
paths = append(paths, meta.ConfigPath)
case ProjectRecordSource:
// 当前目录
curDir, err := os.Getwd()
if err != nil {
panic("Get current dir error")
}
paths = append(paths, curDir)
case SessionRecordSource:
// Shell会话临时目录
paths = append(paths, meta.CurTmpPath)
}
}
// env.Record是用来专门操作.tool-versions文件的, 增删改查
var record env.Record
if len(paths) == 0 {
record = env.EmptyRecord
} else if len(paths) == 1 {
r, err := env.NewRecord(paths[0])
if err != nil {
panic(err)
}
record = r
} else {
r, err := env.NewRecord(paths[0], paths[1:]...)
if err != nil {
panic(err)
}
record = r
}
// SdkManager是用来专门管理Sdk的组件, 到这里Manager就可以通过Record来获取和修改Sdk版本信息咯
return newSdkManager(record, meta)
}
上面提到,最核心的其实是 hook 机制调用的 vfox env <shell-name>
命令,那它到底干了件什么事情呢?
func envCmd(ctx *cli.Context) error {
...
// 拿到对应shell的组件
s := shell.NewShell(shellName)
if s == nil {
return fmt.Errorf("unknow target shell %s", shellName)
}
// 上面提到的加载.tool-versions信息到Manager中
manager := internal.NewSdkManagerWithSource(internal.SessionRecordSource, internal.ProjectRecordSource)
defer manager.Close()
// 获取需要配置的环境变量信息
envKeys, err := manager.EnvKeys()
if err != nil {
return err
}
// 将环境变量信息, 翻译成符合对应shell的命令
exportStr := s.Export(envKeys)
fmt.Println(exportStr)
return nil
}
}
func (m *Manager) EnvKeys() (env.Envs, error) {
shellEnvs := make(env.Envs)
var paths []string
// 这里就是前面说的, Record包含了所有的版本信息, 只需要取出来即可
for k, v := range m.Record.Export() {
if lookupSdk, err := m.LookupSdk(k); err == nil {
if keys, err := lookupSdk.EnvKeys(Version(v)); err == nil {
for key, value := range keys {
if key == "PATH" {
paths = append(paths, *value)
} else {
shellEnvs[key] = value
}
}
}
}
}
...
return shellEnvs, nil
}
没看懂代码没关系,用一句话概括这段代码的功能:将 .tool-versions
记录的 SDK 版本信息,翻译成具体 shell 可执行的命令,其实核心技术就这么朴实无华。
五、插件系统
插件系统是 vfox 的核心,它赋予 vfox 无限的可能性,不仅仅局限于单一的 SDK。通过插件系统,vfox 能够灵活地适应任何 SDK 的需求,无论是现有的还是未来可能出现的。
更重要的是,插件系统使用 Lua 作为插件的开发语言,内置了一些常用模块,如 http
、json
、html
、file
等,这使得插件系统不仅功能强大,而且易于开发和自定义。用户可以根据自己的需求,轻松编写和定制自己的脚本,从而实现更多的功能。
口说无凭,我们直接写一个简单的插件来体验一下,以写一个 Windows 环境下可用的 Python 插件为例。
5.1 插件模板结构
在开工之前,我们首先需要了解一下插件结构是什么样子,以及都提供了哪些钩子函数供我们实现。
--- 内置全局变量: 操作系统和架构类型
OS_TYPE = ""
ARCH_TYPE = ""
--- 描述当前插件的基本信息, 插件名称、版本、最低运行时版本等信息
PLUGIN = {
name = "xxx",
author = "xxx",
version = "0.0.1",
description = "xxx",
updateUrl = "https://localhost/xxx.lua",
minRuntimeVersion = "0.2.3",
}
--- 1.预安装钩子函数。vfox 会根据提供的元信息, 帮你提前下载好所需的文件(如果是压缩包,会帮你解压)放到指定目录。
function PLUGIN:PreInstall(ctx)
return {
version = "0.1.1",
sha256 = "xxx", --- 可选
sha1 = "xxx", --- 可选
url = "文件地址"
}
end
--- 2.后置钩子函数。这里主要是做一些额外操作, 例如编译源码。
function PLUGIN:PostInstall(ctx)
end
--- 3.可用钩子函数。 告诉 vfox 当前插件都有哪些可用版本。
function PLUGIN:Available(ctx)
end
--- 4.环境信息钩子函数。 告诉 vfox 当前SDK所需要配置的环境变量有哪些。
function PLUGIN:EnvKeys(ctx)
end
总共就 4 个钩子函数,是不是非常简单。
5.2 Python 插件实现
OK,万事俱备那我们正式开始实现 Python 插件咯~
--- vfox 提供的库
local http = require("http") --- 发起 http 请求
local html = require("html") --- 解析 html
OS_TYPE = ""
ARCH_TYPE = ""
--- python 下载源地址信息
local PYTHON_URL = "https://www.python.org/ftp/python/"
local DOWNLOAD_SOURCE = {
--- ...
EXE = "https://www.python.org/ftp/python/%s/python-%s%s.exe",
SOURCE = "https://www.python.org/ftp/python/%s/Python-%s.tar.xz"
}
PLUGIN = {
name = "python",
author = "aooohan",
version = "0.0.1",
minRuntimeVersion = "0.2.3",
}
function PLUGIN:PreInstall(ctx)
--- 拿到用户输入版本号, 解析成具体版本号
local version = ctx.version
if version == "latest" then
version = self:Available({})[1].version
end
if OS_TYPE == "windows" then
local url, filename = checkAvailableReleaseForWindows(version)
return {
version = version,
url = url,
note = filename
}
else
--- 非 Windows 环境实现, 略
end
end
function checkAvailableReleaseForWindows(version)
--- 处理架构类型, 同一架构的不同名称
local archType = ARCH_TYPE
if ARCH_TYPE == "386" then
archType = ""
else
archType = "-" .. archType
end
--- 检查是否存在 exe 安装器, 当然 Python 还提供了其他安装器, 例如 msi、web-installer 等
local url = DOWNLOAD_SOURCE.EXE:format(version, version, archType)
local resp, err = http.head({
url = url
})
if err ~= nil or resp.status_code ~= 200 then
error("No available installer found for current version")
end
return url, "python-" .. version .. archType .. ".exe"
end
--- vfox 会在 PreInstall 执行完之后, 执行当前钩子函数.
function PLUGIN:PostInstall(ctx)
if OS_TYPE == "windows" then
return windowsCompile(ctx)
else
--- 略
end
end
function windowsCompile(ctx)
local sdkInfo = ctx.sdkInfo['python']
--- vfox 分配的安装路径
local path = sdkInfo.path
local filename = sdkInfo.note
--- exe 安装器路径
local qInstallFile = path .. "\\" .. filename
local qInstallPath = path
--- 执行安装器
local exitCode = os.execute(qInstallFile .. ' /quiet InstallAllUsers=0 PrependPath=0 TargetDir=' .. qInstallPath)
if exitCode ~= 0 then
error("error installing python")
end
--- 清理安装器
os.remove(qInstallFile)
end
--- 告诉 vfox 可用版本
function PLUGIN:Available(ctx)
return parseVersion()
end
function parseVersion()
--- 这里就是解析对应的 html 页面, 通过正则匹配具体版本号了
local resp, err = http.get({
url = PYTHON_URL
})
if err ~= nil or resp.status_code ~= 200 then
error("paring release info failed." .. err)
end
local result = {}
--- 解析 html 略
return result
end
--- 配置环境变量, 主要是 PATH, 但是注意 Windows 和 Unix-like 路径不一致, 所以要区分
function PLUGIN:EnvKeys(ctx)
local mainPath = ctx.path
if OS_TYPE == "windows" then
return {
{
key = "PATH",
value = mainPath
}
}
else
return {
{
key = "PATH",
value = mainPath .. "/bin"
}
}
end
end
至此,我们就完成了一个 Windows 环境下可用的 Python 插件啦~🎉
![b1a8a677cb2b285bd7d5717f7f44e108.webp](https://filescdn.proginn.com/842b8380000ac0b3170e160bb26a9474/b1a8a677cb2b285bd7d5717f7f44e108.webp)
当然,这只是为了方便演示如何自己实现插件,vfox 目前已经提供了完善的 Python 插件,可以通过 vfox add python/npmmirror
命令直接安装使用哦。
vfox 目前已支持 12 种插件,还在努力丰富中💪💪💪
- Python ✅ ->
python/npmmirror
- Nodejs ✅ ->
nodejs/npmmirror
- Java ✅ ->
java/adoptium-jdk
- Golang ✅ ->
golang/golang
- Dart ✅ ->
dart/dart
- Flutter ✅ ->
flutter/flutter-cn
- .Net ✅ ->
dotnet/dotnet
- Deno ✅ ->
deno/deno
- Zig ✅ ->
zig/zig
- Maven ✅ ->
maven/maven
- Graalvm ✅ ->
java/graalvm
- Kotlin ✅ ->
kotlin/kotlin
- Ruby ⌛️
- PHP ⌛️
六、结束
我的初衷是不管什么语言,只要是需要版本管理,只需要一个工具就能简单高效的完成。所以我创建了 vfox,它是一款专注于多语言、多版本管理的生态工具,目标只有一个:让所有的编程语言版本管理变得简单易用。无论你是 JavaScript、Java 还是 Python 的开发者,vfox 都能为你提供一站式的解决方案。
我们的愿景是创建一个适合国人使用的、简单易用的多语言、多版本管理工具。我们相信,只有真正理解开发者的需求,才能创造出真正有价值的工具。vfox 就是这样的工具,它是为了解决开发者在日常工作中遇到的版本管理问题而生。
GitHub 地址:https://github.com/version-fox/vfox
最后,感谢 HelloGitHub 提供的机会,让我能向更多人介绍 vfox。作为一个开源项目的创作者,我深感开源的力量。它不仅仅是代码的共享,更是知识和经验的共享。希望 vfox 能成为我们沟通的桥梁,欢迎各种形式的反馈和建议,让我们一起变强!
- END -
👆 关注「HelloGitHub」第一时间收到更新 👆