senv—通用多语言版本管理工具

senv - 通用多语言版本管理工具在日常开发中我们经常需要在同一台机器上管理多个版本的开发环境Java 8/11/17/21、Python 3.7/3.9/3.10、Go 1.22/1.24… 手动切换环境变量不仅繁琐还容易出错。今天介绍一个我开发的轻量级工具senv它可以统一管理任意语言的版本切换而且配置完全自由扩展。痛点为什么需要版本管理工具想象这样的场景项目 A 需要 Java 8项目 B 需要 Java 17测试脚本依赖 Python 3.7但新项目用了 3.10 的特性每次切换都要手动改JAVA_HOME、PATH还要记住各种路径市面上已有一些解决方案jEnv: 只支持 Javapyenv: 只支持 Pythongvm: 只支持 Go有没有一个工具能统一管理所有语言这就是 senv 诞生的原因。senv 的设计理念senv 的核心思想很简单配置即一切- 通过 YAML 配置定义任意环境环境变量驱动- 通过修改XXX_HOME和PATH实现切换变量引用- 使用%XXX_HOME%形式保持 PATH 整洁自动备份- 每次切换前自动备份当前环境随时可回退快速开始安装# 克隆项目gitclone https://github.com/yourname/senv.gitcdsenv# 编译go build -o senv.exe# 将 senv.exe 添加到 PATH配置文件在senv_config/env.yaml中配置你的环境java:env_name:JAVA_HOMEbin_path:bincmd_check:javacmd_arg:-versionversions:8:R:/Java/jdk-811:R:/Java/jdk-1117:R:/Java/jdk-1721:R:/Java/jdk-21python:env_name:PYTHON_HOMEbin_path:Scriptsextra_paths:--Tools-Lib/site-packages/qt6_applications/Qt/bincmd_check:pythoncmd_arg:--versionversions:3.7:D:/Python373.9:D:/Python393.10:D:/Python310go:env_name:GOROOTbin_path:bincmd_check:gocmd_arg:versionversions:1.22.1:D:/Go1.22.11.24.5:D:/go1.24.5基本用法# 查看所有配置的环境senv list# 查看 Java 可用版本带 * 的是当前激活版本senv java list# 切换到 Java 17senv javaset17# 查看当前 Python 版本senv python show# 查看所有备份senv backups# 恢复到上一次的环境senv restore last输出示例D:\senv list 支持的环境及版本: Java: 环境变量: JAVA_HOME 8 - R:/Java/jdk-8 11 - R:/Java/jdk-11 * 17 - R:/Java/jdk-17 21 - R:/Java/jdk-21 Python: 环境变量: PYTHON_HOME 3.7 - D:/Python37 3.9 - D:/Python39 * 3.10 - D:/Python310 Go: 环境变量: GOROOT 1.22.1 - D:/Go1.22.1 * 1.24.5 - D:/go1.24.5核心特性详解1. 完全自由的配置扩展不同于其他工具只支持特定语言senv 的配置是完全开放的。你可以在env.yaml中添加任意工具nodejs:env_name:NODE_HOMEbin_path:bincmd_check:nodecmd_arg:--versionversions:18:D:/nodejs1820:D:/nodejs20maven:env_name:MAVEN_HOMEbin_path:bincmd_check:mvncmd_arg:--versionversions:3.8:D:/apache-maven-3.83.9:D:/apache-maven-3.9gradle:env_name:GRADLE_HOMEbin_path:bincmd_check:gradlecmd_arg:--versionversions:7.6:D:/gradle-7.68.0:D:/gradle-8.0添加后立刻生效无需修改任何代码senv nodejsset20senv mavenset3.92. 智能 PATH 管理senv 使用变量引用方式管理 PATH而不是写入绝对路径# 切换前 PATHC:\Windows\system32;... # 切换后Java 为例 PATH%JAVA_HOME%\bin;C:\Windows\system32;...这样做的好处PATH 长度不会因多版本而爆炸修改JAVA_HOME后 PATH 自动指向新版本无残留切换干净彻底3. 完整的备份机制每次执行set命令前senv 会自动备份当前的所有环境变量已备份环境变量到: senv_config\backups\backup_20260227_143052.yaml备份文件内容示例timestamp:2026-02-27 14:30:52language:javaversion:17env_vars:PATH:...JAVA_HOME:R:/Java/jdk-8PYTHON_HOME:D:/Python310GOROOT:D:/go1.24.5随时可以回退senv restore last# 恢复到最新备份senv restore backup_xxx.yaml# 恢复到指定备份4. 跨平台支持虽然主要面向 Windows 开发使用reg和setx操作注册表但代码结构预留了跨平台接口funcgetUserEnvVar(namestring)string{ifruntime.GOOS!windows{returnos.Getenv(name)// Linux/Mac 直接读环境变量}// Windows 从注册表读取cmd:exec.Command(reg,query,HKCU\\Environment,/v,name)...}实现原理配置解析使用gopkg.in/yaml.v3解析配置Config 定义为通用的 maptypeLanguageConfigstruct{EnvNamestringyaml:env_name// JAVA_HOME, PYTHON_HOME...BinPathstringyaml:bin_path// bin, Scripts...ExtraPaths[]stringyaml:extra_paths// 额外 PATH 路径Versionsmap[string]stringyaml:versions// 版本映射CmdCheckstringyaml:cmd_check// 检查命令CmdArgstringyaml:cmd_arg// 检查参数}typeConfigmap[string]*LanguageConfig// 支持任意语言版本切换流程备份- 保存当前所有相关环境变量设置 XXX_HOME- 使用setx写入用户环境变量清理旧 PATH- 移除包含旧%XXX_HOME%引用的路径添加新 PATH- 在 PATH 开头添加%XXX_HOME%\bin去重写入- 合并并设置新的 PATH安全性设计路径存在检查- 切换前验证版本路径是否存在PATH 长度检查- 超过 2048 字符时警告并中止操作确认- 显示即将添加的 PATH 变更需要用户确认源码结构senv/ ├── main.go # 主程序入口 ├── go.mod # Go 模块定义 ├── go.sum # 依赖锁定 ├── senv.exe # Windows 可执行文件 ├── senv_config/ │ ├── env.yaml # 环境配置文件 │ └── backups/ # 自动备份目录 │ ├── backup_20260227_143052.yaml │ └── ... └── build.bat # 构建脚本与同类工具对比特性senvjEnvpyenvgvm多语言支持✅ 任意语言❌ Java 专用❌ Python 专用❌ Go 专用配置扩展✅ YAML 自由配置❌ 固定❌ 固定❌ 固定自动备份✅ 每次切换备份❌ 无❌ 无❌ 无环境隔离✅ 变量引用✅ shim✅ shim✅ 独立目录PATH 长度✅ 短变量引用✅ 短⚠️ 可能很长✅ 短回滚机制✅ 完整备份恢复❌ 无❌ 无❌ 无平台支持 Windows/Linux/Mac✅ 全平台✅ 全平台✅ 全平台使用建议适合场景多项目需要不同版本环境快速测试代码在不同版本的兼容性团队统一环境配置共享 env.yaml需要频繁切换开发环境注意事项需要新开终端-setx修改的环境变量不会立即生效PATH 长度- Windows 有 2048 字符限制建议定期清理 PATH管理员权限- 某些情况下可能需要管理员权限修改环境变量未来计划支持环境变量模板如JAVA_OPTS项目级.senvrc自动切换版本别名如lts、latestShell 自动补全跨平台完整支持Linux/Mac 环境变量管理结语senv 是一个简单但实用的工具它用最直接的方式解决了多版本环境管理的问题。没有复杂的 shim 机制没有庞大的依赖只有清晰的理念配置即代码简单即强大。如果你也受够了手动切换环境变量不妨试试 senv。