开发工具CLI【免费下载链接】sdkman-cliThe SDKMAN! Command Line Interface项目地址https://gitcode.com/gh_mirrors/sd/sdkman-cli点击查看免费下载SDKMAN! 是一个运行在任何 Unix 系操作系统上的软件开发工具包Software Development Kit管理器其核心价值在于以统一的命令行接口对多个 SDK 的并行多版本进行安装、切换、移除与列举。本文将以本仓库sdkman-cliSDKMAN! 的命令行实现为核心系统讲解其安装方式、命令体系、核心 Bash 实现原理、配置项、.sdkmanrc项目级环境管理以及基于 Cucumber 的 BDD 测试体系帮助你从“会用”进阶到“懂原理”。一、SDKMAN! CLI 是什么根据 README.md 的定义SDKMAN! 是一个用于在任意 Unix 系系统上管理多个软件开发工具包并行版本的工具它提供了便于安装、切换、移除和列举候选工具Candidate的命令行接口。所谓“候选工具”指的是被 SDKMAN! 托管的 SDK 本身例如 Java、Groovy、Scala、Kotlin、Maven、Gradle 等。每个候选工具可以同时拥有多个已安装版本用户可以在不同项目、不同 shell 中自由切换这是它区别于系统级包管理器如 apt、yum的关键能力。需要特别关注的是 README.md 中的NOTICE声明目前项目官方正在用 Rust 语言在一个新项目 sdkman-cli-native 中重写全部命令本仓库将逐渐退化为新 Rust 命令的轻量包装器/启动器。也就是说本仓库Bash 实现的 CLI当前仍可正常使用该 Bash 项目进入“仅修复缺陷、不再新增功能”的维护冻结期未来命令实现会迁移到 Rust 原生二进制再通过本仓库的轻量 wrapper 调用。这一背景决定了阅读本仓库的 Bash 源码恰恰是理解 SDKMAN! 命令语义与行为契约最准确的途径因为官方文档描述的行为都以这些脚本为准。二、快速安装 SDKMAN!2.1 一键安装脚本在任意终端中执行 README.md 提供的官方安装命令$ curl -s https://get.sdkman.io | bash安装器会自动检测当前环境若系统缺少依赖或需要调整环境例如unzip、curl等工具不存在安装器会给出提示并要求重启终端后继续安装完成后需要重新打开终端或在当前 shell 中source $HOME/.sdkman/bin/sdkman-init.sh以完成初始化。2.2 安装后的目录结构SDKMAN! 安装在$HOME/.sdkman下其目录布局可以通过 sdkman-init.sh 的初始化逻辑反推出来主要包括路径用途~/.sdkman/bin/sdk入口脚本与sdkman-init.sh~/.sdkman/src/各命令的 Bash 实现脚本sdkman-*.sh~/.sdkman/etc/config用户配置文件见下文第五节~/.sdkman/var/运行状态文件如candidates缓存、platform、version、delay_upgrade~/.sdkman/candidates/所有候选工具的实际安装目录~/.sdkman/ext/扩展脚本目录以sdkman-*.sh命名~/.sdkman/contrib/completion/Bash 补全脚本本仓库中的 contrib/completion/bash/sdk2.3 安装后的初始化流程每次打开新 shellsdkman-init.sh会依次完成设定环境变量若未定义SDKMAN_CANDIDATES_API候选元数据 API与SDKMAN_BROKER_API下载分发 API则填充编译期注入的默认值源码中的SDKMAN_CANDIDATES_API、SDKMAN_BROKER_API占位符在构建时替换若未定义SDKMAN_DIR则默认指向$HOME/.sdkman。加载用户配置若存在${SDKMAN_DIR}/etc/config则以source方式引入。识别平台读取${SDKMAN_DIR}/var/platform并通过uname -s识别 Cygwin、Darwin、SunOS、FreeBSD。识别 shell根据ZSH_VERSION/BASH_VERSION判断 zsh 或 bash。加载全部脚本遍历${SDKMAN_DIR}/src与${SDKMAN_DIR}/ext下所有sdkman-*.sh并逐个source这正是扩展机制的基础。候选缓存读取读取${SDKMAN_DIR}/var/candidates中的 CSV将其解析为候选数组。PATH 装配对每个已安装候选的current符号链接执行导出*_HOME与 PATH 前置见 sdkman-init.sh。补全与自动 env根据sdkman_auto_complete配置加载 Bash/Zsh 补全根据sdkman_auto_env配置挂载目录切换时的自动.sdkmanrc加载钩子sdkman-init.sh。三、sdk命令体系与命令分发机制3.1 命令入口与别名SDKMAN! 的所有操作统一通过sdk命令进行。命令分发逻辑位于 sdkman-main.sh 的sdk()函数中其执行流程为别名归一化l/ls → list、v → version、u → use、i → install、rm → uninstall、c → current、ug → upgrade、d → default、h → home、e → env。候选缓存检查除update外任何命令执行前都会校验候选缓存文件是否存在见 sdkman-main.sh。服务可用性探测调用__sdkman_update_service_availability探测网络设置SDKMAN_AVAILABLE。命令查找先在${SDKMAN_DIR}/src/sdkman-${COMMAND}.sh中查找内建命令再在${SDKMAN_DIR}/ext/sdkman-${COMMAND}.sh中查找扩展命令若都不存在则报Invalid command。原生命令优先当配置sdkman_native_enabletrue且${SDKMAN_DIR}/libexec/${COMMAND}存在时直接执行 Rust 原生二进制并把剩余参数透传sdkman-main.sh——这正是 README 中“Rust 重写 轻量 wrapper”过渡方案的落点。候选名校验对带 qualifier 的命令校验候选名是否合法help、flush、selfupdate、env、completion、edit、home除外。分派执行将命令名中的-替换为_调用对应的__sdk_commandshell 函数。3.2 核心命令速查结合仓库中的命令脚本核心命令的功能如下命令功能实现文件sdk list列出全部候选工具sdk list candidate列出某候选的全部可用版本在线或已安装版本离线sdkman-list.shsdk install candidate [version] [local-path]安装指定版本或从本地目录链接安装sdkman-install.shsdk uninstall candidate version移除指定版本sdkman-uninstall.shsdk use candidate version仅在当前 shell 中临时切换版本sdkman-use.shsdk default candidate version设置全局默认版本sdkman-default.shsdk current [candidate]显示当前正在使用的版本sdkman-current.shsdk upgrade [candidate]升级候选工具或全部候选sdkman-upgrade.shsdk home candidate version输出指定版本安装目录的绝对路径sdkman-home.shsdk env项目级环境管理详见第六节sdkman-env.shsdk flush清理缓存sdkman-flush.shsdk selfupdate [force]更新 SDKMAN! 自身sdkman-selfupdate.shsdk version显示版本sdkman-version.sh四、安装机制详解下载、校验与本地链接install是 SDKMAN! 最核心的命令其完整流程可以在 sdkman-install.sh 中追踪4.1 标准安装流程确定版本__sdkman_determine_version解析用户输入若省略版本号则向 API 查询该候选的默认版本。幂等检查若${SDKMAN_CANDIDATES_DIR}/${candidate}/${version}目录或符号链接已存在则提示“already installed”并直接返回sdkman-install.sh。下载__sdkman_download从${SDKMAN_BROKER_API}/download/${candidate}/${version}/${platform_parameter}下载二进制并把响应头中的X-Sdkman-*元数据含校验和保存为.headers文件。后安装钩子从${SDKMAN_CANDIDATES_API}/hooks/post/...拉取远程 post-installation hook 脚本并source执行该 hook 负责把原始二进制转换为最终的.zipsdkman-install.sh。这一设计使同一安装框架能适配不同候选不同的发布格式。完整性校验__sdkman_validate_zip使用unzip -t检查压缩包完整性损坏则删除并提示重试__sdkman_checksum_zip依据响应头中的X-Sdkman-Checksum-*头优先用shasumSHA 系或md5sumMD5校验校验失败即删除归档并中止sdkman-install.sh。解压落盘unzip到临时目录后mv至${SDKMAN_CANDIDATES_DIR}/${candidate}/${version}。默认设置询问若当前候选已有 default 版本且未开启sdkman_auto_answer/auto_answer_upgrade则询问Do you want candidate version to be set as default? (Y/n)回答 Y 后通过__sdkman_link_candidate_version更新current符号链接并刷新 PATHsdkman-install.sh。4.2 本地目录链接安装install还支持第三种参数形式——从本地已解压的 SDK 目录安装$ sdk install my-sdk 1.0.0 /opt/my-sdk对应__sdkman_install_local_version的实现sdkman-install.sh版本号长度上限为 20 个字符超出报错相对路径会以当前工作目录为基准解析为绝对路径目标目录存在时以ln -s符号链接的方式挂入${SDKMAN_CANDIDATES_DIR}/${candidate}/${version}而不是复制文件因此不会占用额外磁盘空间。4.3 下载容错与安全配置下载行为由 sdkman-utils.sh 中的__sdkman_secure_curl_download控制其参数取自用户配置sdkman_curl_continuetrue时追加-C -支持断点续传sdkman_curl_retry/sdkman_curl_retry_max_time控制重试次数与最长重试时间sdkman_insecure_ssltrue时追加--insecuresdkman_debug_modetrue时追加--verbose常规 API 请求则使用__sdkman_secure_curl/__sdkman_secure_curl_with_timeouts后者携带连接超时默认 7s与最大时长默认 10s限制。五、配置体系etc/config 与关键开关5.1 配置文件的打开方式SDKMAN! 的用户配置集中在${SDKMAN_DIR}/etc/config。可通过两种方式编辑$ sdk config # 使用 $EDITOR默认 vi打开配置文件__sdk_config的实现sdkman-config.sh会校验EDITOR环境变量对应的编辑器是否存在不存在则提示先设置EDITOR。5.2 关键配置项以下配置项均可写入etc/config中生效其默认值与作用均可在仓库源码中验证配置项默认值作用sdkman_auto_answerfalse安装时是否自动回答交互式提问不等待输入sdkman_auto_completetrue是否启用 Bash/Zsh 命令补全sdkman-init.shsdkman_auto_envfalse进入含.sdkmanrc的目录时是否自动加载项目环境sdkman-init.shsdkman_beta_channelfalse是否使用 beta 更新通道sdkman-selfupdate.shsdkman_checksum_enabletrue安装时是否执行 SHA/MD5 校验sdkman-install.shsdkman_curl_connect_timeout7curl 连接超时秒sdkman-init.shsdkman_curl_max_time10curl 最大请求时长秒sdkman-init.shsdkman_curl_retry0curl 重试次数sdkman_curl_retry_max_time60curl 最长重试时间秒sdkman_curl_continuetrue下载是否支持断点续传sdkman_debug_modefalse是否输出调试日志__sdkman_echo_debug的门控开关sdkman_insecure_sslfalse是否跳过 SSL 校验内网/代理场景sdkman_selfupdate_featurefalse是否启用selfupdate命令默认命令存在但被门控见 sdkman-main.shsdkman_native_enablefalse是否优先执行libexec下的 Rust 原生命令sdkman_auto_env相关—目录切换自动加载项目环境六、.sdkmanrc项目级环境管理SDKMAN! 提供了类似.nvmrc/.python-version的项目级版本声明机制让每个项目可以锁定自己所需的 SDK 版本组合。所有逻辑都位于 sdkman-env.sh。6.1 初始化.sdkmanrc$ sdk env init__sdkman_create_env_file会生成一个.sdkmanrc文件若当前 shell 正在使用某个 Java 版本则写入该版本否则向 API 查询 Java 默认版本。生成的文件内容形如# Enable auto-env through the sdkman_auto_env config # Add keyvalue pairs of SDKs to use below java17.0.9-tem你可以继续追加其他候选例如java17.0.9-tem maven3.9.6文件格式由__sdkman_env_each_candidate解析每行candidateversion支持空行与#注释候选名必须全小写正则^[[:lower:]]\.$校验见 sdkman-env.sh。6.2 应用与安装环境$ sdk env # 按 .sdkmanrc 在当前 shell 切换版本 $ sdk env install # 先安装 .sdkmanrc 中缺失的版本再切换sdk env调__sdkman_load_env对每个candidateversion执行__sdk_use成功后将SDKMAN_ENV设为当前目录sdk env install调__sdkman_setup_env对每个条目执行__sdkman_install_keeping_default以sdkman_auto_answertrue USEn的方式调用__sdk_install确保安装新版本时不会改动已有的全局 default 版本sdkman-env.sh。6.3 清理环境$ sdk env clear__sdkman_clear_env会遍历.sdkmanrc把当前 shell 中切换过的候选恢复为各自的全局 default 版本并清除SDKMAN_ENV。6.4 自动加载可选在etc/config中设置sdkman_auto_envtrue后进入含.sdkmanrc的目录时会自动执行sdk env。实现上zsh 通过向chpwd_functions注册钩子bash 则通过改写PROMPT_COMMAND见 sdkman-init.sh并在离开该目录时自动sdk env clear。七、更新与自升级update / selfupdate7.1sdk updateupdate命令刷新候选工具列表缓存写回${SDKMAN_DIR}/var/candidates这是新候选工具被纳入管理的前提。由于sdk入口对所有非update命令都会先校验候选缓存sdkman-main.sh首次使用 SDKMAN! 时通常需要先执行一次sdk update。7.2sdk selfupdate [force]selfupdate用于升级 SDKMAN! 自身其逻辑在 sdkman-selfupdate.sh在线状态下分别比较 script 与 native 两部分的本地版本var/version、var/version_native与远端版本远端版本查询走broker/version/sdkman/script/{stable,beta}与broker/version/sdkman/native/{stable,beta}两类接口通道由sdkman_beta_channel决定版本不同或显式传入force时执行${SDKMAN_CANDIDATES_API}/selfupdate/{stable,beta}/${SDKMAN_PLATFORM}返回的更新脚本管道给bash执行版本一致且未加force时输出 “No update available at this time.”。八、候选缓存与离线行为候选列表被缓存在${SDKMAN_DIR}/var/candidates初始化时被解析为SDKMAN_CANDIDATES数组sdk list无参数需要在线访问${SDKMAN_CANDIDATES_API}/candidates/listsdk list candidate在线时访问版本列表接口并把“当前版本”与“已安装版本”一并编码为查询参数注意 sdkman-utils.sh 中的编码为%2B以正确处理21.0.112-open这类含 build metadata 的版本号离线时sdk list candidate自动降级为只展示本机已安装版本并标记*已安装与当前使用见 sdkman-list.sh。九、使用sdk use与sdk default的版本切换sdk use candidate version只影响当前 shell__sdkman_set_candidate_home更新*_HOME环境变量随后用正则替换当前 PATH 中该候选的版本段sdkman-use.sh若该候选尚无current链接则将其设为 defaultsdk default candidate version则通过更新current符号链接持久化默认版本影响所有新打开的 shell二者的共同基础是“current符号链接 PATH 前置”模型初始化时所有候选的current链接目标会被导出为*_HOME并前置到 PATHsdkman-init.sh。十、BDD 测试体系用 Cucumber 描述 CLI 行为README.md 强调SDKMAN! 的所有 CLI 行为 BDD 测试均以 Cucumber 编写并可通过 Gradle 一键运行。10.1 运行测试$ ./gradlew test10.2 测试基础设施Cucumber 运行器位于 RunCukeTests.groovy关键配置为features [src/test/resources/features]feature 文件目录glue [sdkman.steps]步骤定义包即 src/test/groovy/sdkman/steps 下的各*_steps.groovytags [not manual, not review]排除手工与待审阅场景。10.3 测试支撑组件测试并非直接调用真实网络而是依赖仓库内的桩Stub组件组件用途WebServiceStub.groovy模拟 SDKMAN! 后端 Web 服务WireMockServerProvider.groovy基于 WireMock 提供 HTTP 桩CurlStub.groovy拦截并模拟curl调用UnameStub.groovy固定uname输出以模拟不同平台HookResponses.groovy模拟 post-installation hook 响应spec 级测试如 InitialisationSpec.groovy、EnvCommandSpec.groovy、ConfigCommandSpec.groovy则从更细粒度验证对应命令脚本在特定环境下的行为。10.4 开发环境的 JDKREADME 指出进行开发需要 JDK 11可通过 SDKMAN! 自己安装$ sdk env install该命令会在仓库根目录存在.sdkmanrc的前提下依据文件声明的 Java 版本自动安装并切换——这正是第六节介绍的“项目级环境管理”在 SDKMAN! 自身开发流程中的实际应用。十一、快速上手指南从零开始使用 SDKMAN! 的完整路径# 1. 安装 $ curl -s https://get.sdkman.io | bash # 重开终端或 source ~/.sdkman/bin/sdkman-init.sh # 2. 刷新候选列表 $ sdk update # 3. 查看可用候选 $ sdk list # 4. 安装 Java 最新版本 $ sdk install java # 5. 在当前 shell 临时切换版本 $ sdk use java 17.0.9-tem # 6. 设置为全局默认 $ sdk default java 17.0.9-tem # 7. 为项目锁定版本 $ cd my-project sdk env init sdk env install # 8. 查看当前使用状态 $ sdk current # 9. 升级 SDKMAN! 自身 $ sdk selfupdate十二、结语与过渡期注意事项本文以 README.md 为主线结合仓库源码完整梳理了 SDKMAN! CLI 的安装、命令分发、安装校验、配置、.sdkmanrc项目环境与 BDD 测试体系。需要再次提醒的是该项目正处于向 Rust 原生实现sdkman-cli-native迁移的过渡期当前 Bash 实现进入维护冻结、只修缺陷不再增强。对于生产环境使用者建议持续关注官方发布渠道以跟进 Rust 版本的落地进度对于想要深入理解 SDKMAN! 行为契约的开发者和测试工程师本仓库的 Bash 脚本与 Cucumber 测试仍是目前最权威、最可执行的参考实现。赞分享开发工具CLI【免费下载链接】sdkman-cliThe SDKMAN! Command Line Interface项目地址https://gitcode.com/gh_mirrors/sd/sdkman-cli点击查看免费下载相关推荐【免费下载】 在Mac上使用SDKMAN管理多版本开发工具链基于sb2nov/mac-setup项目在Mac上使用SDKMAN管理多版本开发工具链基于sb2nov/mac setup项目 什么是SDKMAN SDKMANSoftware Developm文档教程开发工具SDKMAN! CLI终极指南10分钟快速掌握多版本SDK管理神器SDKMAN! CLI终极指南10分钟快速掌握多版本SDK管理神器 SDKMAN! CLI是一款功能强大的命令行工具专为开发者设计用于在类Unix系统上管开发工具CLISpotify多账户管理基于cli3/cli的切换工具开发Spotify多账户管理基于cli3/cli的切换工具开发 你是否经常需要在个人和工作Spotify账户间切换频繁登录登出不仅繁琐还可能导致播放列表同步问开发工具CLI上一篇gnhf 开发者指南从代码结构到 CI 流水线参与这个夜间 AI 编程项目的完整路径下一篇typescript-book 项目解读TypeScript 7.0 原生编译器发布与迁移指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考