Skip to content

Latest commit

 

History

History
125 lines (84 loc) · 4.85 KB

README_CN.md

File metadata and controls

125 lines (84 loc) · 4.85 KB

Logo

vfox

Go Report Card GitHub License GitHub Release Discord

[English] [中文文档]

如果你经常需要在各种开发项目之间切换,而这些项目又各自需要不同的运行环境,尤其是不同的运行时版本或环境库, 或者 厌倦了各种繁琐的环境配置,那么 vfox 就是你的不二选择。

介绍

vfox 是一个跨平台版本管理器(类似于 nvmfvmsdkmanasdf-vm 等),可通过插件扩展。它允许您快速安装和切换您需要的环境。

为什么选择 vfox?

  • 支持Windows(非WSL)、Linux、macOS!
  • 支持不同项目不同版本不同Shell不同版本以及全局版本
  • 简单的 插件系统 来添加对你选择的语言的支持
  • 在您切换项目时, 帮您自动切换运行时版本
  • 支持现有配置文件 .node-version.nvmrc.sdkmanrc,以方便迁移
  • 支持常用Shell(Powershell、Bash、ZSH),并提供补全功能
  • asdf-vm 更快,并提供更简单的命令和真正的跨平台统一。参见 与asdf-vm对比

演示

asciicast

快速入门

详细的安装指南请参见 快速入门

1.选择一个适合你的安装方式

2. ⚠️ 挂载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
if (-not (Test-Path -Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }; Add-Content -Path $PROFILE -Value 'Invoke-Expression "$(vfox activate pwsh)"'

# Clink:
# 1. 安装 clink: https://github.com/chrisant996/clink/releases
#    或者安装 cmder: https://github.com/cmderdev/cmder/releases
# 2. 找到脚本路径: clink info | findstr scripts
# 3. 复制 internal/shell/clink_vfox.lua 到脚本路径

请记住重启你的 Shell 以应用更改。

3.添加插件

$ vfox add nodejs

4. 安装运行时

$ vfox install [email protected]

5. 切换运行时

$ vfox use [email protected]
$ node -v
21.5.0

完整文档

请浏览 vfox.lhan.me 查看完整文档。

目前支持的插件

如果您已经安装了 vfox,您可以使用 vfox available 命令查看所有可用的插件。

请看 可用插件列表

路线图

我们未来的计划以及高度优先的功能和增强功能是:

  • 重构插件机制:
    • 增加插件模板, 允许多文件开发插件
    • 增加全局注册表(类似于:NPM RegistryScoop Main Bucket), 为插件分发提供统一入口
    • 拆分现有的插件仓库, 一个插件一个仓库
  • 允许切换注册表地址
  • 插件能力: 允许插件解析旧版本的配置文件. 例如: .nvmrc, .node-version, .sdkmanrc
  • 插件能力: 允许插件加载已安装的运行时, 并提供运行时的信息

贡献者

感谢以下贡献者对本项目的贡献。🎉🎉🙏🙏

Star History

Star History Chart

感谢

感谢 JetBrains 提供免费开源许可 : )

Featured|HelloGitHub

COPYRIGHT

Apache 2.0 license - Copyright (C) 2024 Han Li and contributors