asdf 依赖清单与安装指南Bash 与 Git 版本要求及多平台安装命令【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf导读本篇技术指南围绕 asdf 官方文档 Dependencies 页面 展开系统说明 asdf 0.16.0 及以上版本运行所需的最低依赖Bash3.2.48、Git1.7.7.2并给出 Linux 与 macOS 下各主流包管理器的依赖安装命令。读完本文你将能够确认自己的系统是否满足 asdf 运行前提、在任意受支持平台上手动补齐依赖并理解为什么 asdf 本身对依赖的需求如此精简、而插件生态又为何要求额外的系统工具。asdf 的最小依赖为什么只需 Bash 与 Gitasdf 是一个可扩展的版本管理器Extendable version manager支持 Ruby、Node.js、Elixir、Erlang 等众多工具。作为一个薄管理核心它在 0.16.0 及以上版本中对宿主系统提出了极低的依赖要求仅需两个组件依赖最低版本Bash3.2.48Git1.7.7.2此清单适用于 asdf 0.16.0 及更高版本。旧版本的 asdf 具有额外的依赖例如更早版本曾要求curl、gawk等如果你仍在使用旧版 asdf请参考对应版本的发布说明与文档。版本要求的实际意义Bash3.2.48这是 macOS 长期内置的 Bash 版本自 macOS Catalina 起系统默认 shell 虽改为 ZSH但 Bash 3.2 仍随系统提供。asdf 的 shell 集成脚本与命令执行逻辑依赖该版本及以上的 Bash 特性因此绝大多数 macOS 与主流 Linux 发行版均天然满足此要求。Git1.7.7.2asdf 核心通过 Git 完成插件克隆、仓库更新、标签/版本列表拉取等操作仓库内 internal/git/git.go 封装了相关底层逻辑。该版本发布于 2011 年基本覆盖所有现代发行版。如何验证依赖版本你可以在终端中直接确认当前环境是否满足要求# 查看 Bash 版本 echo $BASH_VERSION # 查看 Git 版本 git --version此外asdf 内置的asdf info命令会打印完整的调试信息其中包含 BASH VERSION 字段见 internal/info/info.go 的实现通过echo $BASH_VERSION采集版本号。当你提交 bug 报告或排查环境问题时先运行asdf info并把输出附上可以快速定位是否由依赖版本不满足引起。插件依赖容易被忽略的第二层依赖::: tip 重要提示asdf 插件可能在使用前要求安装额外的程序。在安装插件之前请务必阅读该插件的文档确认其全部依赖都已安装。:::这是文档中最常被忽略的一点asdf 核心只要求 Bash 与 Git但每个插件是独立的项目由社区维护可能依赖编译工具链、GPG、curl、gawk 等系统程序。例如官方 Getting Started 指南 中Node.js 插件asdf-nodejs的依赖因操作系统而异操作系统依赖安装命令Debianapt-get install dirmngr gpg curl gawkCentOS / Rocky Linux / AlmaLinuxyum install gnupg2 curl gawkmacOSbrew install gpg gawk文档特别提醒部分插件存在 post-install 钩子安装后钩子这些钩子会在插件安装完成后立即执行如果依赖缺失钩子脚本可能直接失败。因此正确顺序是先装依赖再装插件。手动安装依赖各平台命令对照如果你需要为 asdf 手动安装依赖请根据你的操作系统执行下表中的命令对应文档引用的 install-dependencies-cmds.md 片段操作系统包管理器命令LinuxAptitudeapt install git bashLinuxDNFdnf install git bashLinuxPacmanpacman -S git bashLinuxZypperzypper install git bashmacOSHomebrewbrew install coreutils git bashmacOSSpackspack install coreutils git bash命令说明与注意事项Linux 各发行版AptitudeDebian/Ubuntu 系、DNFFedora/RHEL 系、PacmanArch 系、ZypperopenSUSE 系分别对应不同生态的包管理器按你的发行版选择其一即可无需全部执行。macOSHomebrew 是主流选择Spack 是面向科学计算场景的包管理器两者都额外安装了coreutils。原因在于 macOS 系统自带的 BSD 风格核心工具与 GNU coreutils 存在差异安装 GNU coreutils 可以确保依赖asdf的脚本行为一致。sudo权限取决于你的系统配置这些安装命令可能需要sudo前缀。如果当前用户无写权限请在命令前加上sudo。表中列出的工具通常是主流发行版预装的多数情况下你并不需要手动执行这些命令——只有当你从预编译二进制或源码编译方式安装 asdf见下文且系统中恰好缺失 Git 时才需要回头执行上述安装。什么情况下会用到这张表Getting Started 指南 展示了 asdf 的多种安装途径包管理器安装推荐brew install asdf、zypper install asdf、Pacman AUR 等方式安装时包管理器通常会自动带上 Git、Bash 等运行时依赖一般无需手动处理。下载预编译二进制从 Releases 页面下载归档解压即可用此时需要自己保证系统已有 Git。go install安装go install github.com/asdf-vm/asdf/cmd/asdfv0.20.0同样要求系统已具备 Git。源码编译克隆仓库后执行make对应仓库根目录的 Makefile核心是go build -ldflags${LINKER_FLAGS} -o./asdf ./cmd/asdf编译出的二进制同样依赖外部 Git。采用后三种方式时如果系统缺少 Git就会出现asdf 装好了但无法添加/更新插件的现象此时回到上表把依赖补齐即可。从源码佐证依赖在 asdf 运行中的角色结合当前仓库源码可以进一步印证依赖清单的合理性Git 是插件管理的基石asdf 的插件机制依赖 Git 仓库。asdf plugin add从远程仓库克隆插件asdf plugin update拉取更新版本列表的获取也涉及对仓库的操作。仓库内 internal/git/git.go 专门封装这些 Git 操作是核心依赖之一。Bash 承担命令执行与 Shell 集成asdf 的插件脚本约定基于 Bash如bin/install、bin/list-all等asdf 通过 shell 执行它们。从 internal/execute/execute.go 的实现看核心命令的执行大量经由 shell 完成同时asdf在 Bash/ZSH 等 shell 中的初始化脚本见 docs/guide/getting-started.md 的 PATH 配置部分也依赖 Bash 兼容语法。asdf info可直接定位依赖问题internal/info/info.go 中Write函数会依次输出 OS、SHELL、BASH VERSION、ASDF VERSION 及已安装插件列表。当你的环境不满足 Bash 版本要求时通过asdf info输出即可第一时间发现。同时需要注意仓库中 scripts/install_dependencies.bash 是为 CIGitHub Actions准备的环境准备脚本它安装的是测试所需的 Elvish、Nushell、PowerShell、Fish 等 shell 环境与 bats-core 测试框架并非 asdf 运行时的最小依赖。日常使用 asdf 无需参考该脚本——这正说明了 asdf 本身依赖极简、插件各取所需的设计哲学。小结三步确认你的 asdf 环境就绪验证核心依赖运行echo $BASH_VERSION与git --version确认 Bash ≥3.2.48、Git ≥1.7.7.2按需补齐若系统缺失 Git/Bash参照上文手动安装依赖表格按你的包管理器执行对应命令必要时加sudo检查插件依赖安装每个插件前阅读插件文档先装齐其声明的系统依赖再执行asdf plugin add。完成以上三步后你的 asdf 环境即满足官方文档 Dependencies 的全部要求可以放心进入插件安装与工具版本管理流程。更多命令与配置说明可继续阅读 核心命令参考、插件管理 与 版本管理。【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考