尧图网页设计 
asdf 依赖清单与安装指南核心版本要求、跨平台命令与插件依赖管理【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdfasdf 是一个可扩展的多运行时版本管理器支持 Ruby、Node.js、Elixir、Erlang 等众多语言工具的统一安装与版本切换。本文基于韩文版官方文档《의존성 목록》即 docs/ko-kr/manage/dependencies.md展开系统梳理 asdf 0.16.0 及更高版本对 Bash 与 Git 的版本要求、各操作系统下的依赖安装命令、插件层额外的依赖注意事项并结合本仓库源码如 internal/git/git.go、scripts/install_dependencies.bash说明这些依赖在 asdf 运行链路中的实际作用。读完后你将能够针对自己的操作系统准确、完整地安装 asdf 所需的全部依赖并懂得如何排查插件层面的依赖缺失问题。一、asdf 核心依赖与版本要求asdf 本身core在运行时只依赖两个外部程序Bash版本不低于3.2.48Git版本不低于1.7.7.2需要特别强调的是这份依赖清单是针对 asdf 0.16.0 及以上版本的。如果使用的是更早版本的 asdf可能还需要安装额外的依赖——因此文档明确指出旧版本的 asdf 需要额外的依赖原文이전 버전의 asdf는 추가적인 의존성이 필요합니다。建议升级到 0.16.0 或更高版本以获得最精简的依赖集合。提示本仓库当前 version.txt 中记录的版本为0.15.0而韩文版 getting-started 中以v0.20.0为例演示构建与安装依赖清单以官方文档声明的 0.16.0 为适用前提。为什么核心依赖恰好是 Bash 与 Git从源码结构可以清晰地看到这两项依赖的用途Git 承担了插件与插件索引仓库的全部版本控制操作。internal/git/git.go 是 asdf 对 Git 仓库操作的核心封装其Repoer接口定义了Clone、Head、RemoteURL、Update四个操作分别对应插件安装clone、查询当前提交、读取远端地址、拉取更新。具体实现直接调用系统git命令行例如// Clone installs a plugin via Git func (r Repo) Clone(pluginURL, ref string) error { cmdStr : []string{git, clone, --depth, 1, pluginURL, r.Directory} // ... _, stderr, err : exec(cmdStr) // ... }更新插件时同样通过git fetch --prune --update-head-ok与git checkout --force组合完成见 internal/git/git.go。Head()则使用git rev-parse HEAD获取当前提交。由此可见asdf 的插件机制本质上建立在系统 Git 之上——安装、升级插件都要调用git可执行文件因此 Git 是 asdf 不可或缺的运行依赖。Bash 则支撑了插件脚本生态。asdf 插件本身由 Bash 脚本编写测试目录 test/fixtures 下的dummy_plugin等即为此类插件的示例版本解析、安装回调和 shim 模板等执行链路都依赖 Bash 解释器。从构建依赖角度go.mod 中虽然引入了github.com/go-git/go-git/v5库但从当前 internal/git/git.go 的实现看实际仓库操作仍通过execute.New(git, ...)调用系统 Git 命令这也印证了文档asdf 自身必须安装 Git的要求并非虚设。二、按操作系统安装依赖的命令如果目标机器上尚未安装 Bash 或 Git文档提供了各主流操作系统/包管理器对应的安装命令。下表完整罗列与 docs/ko-kr/parts/install-dependencies-cmds.md 中include引入的内容一致操作系统包管理器命令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 系的安装命令都是同时安装git与bash两个包。macOS 系Homebrew 命令额外安装了coreutils——这是为了让 GNU 风格的核心工具可用因为 macOS 自带的 BSD 工具集与部分脚本的 GNU 行为存在差异Spack面向 HPC/科研环境的包管理器同样提供coreutils git bash。关于sudo文档特别注明根据系统配置可能需要sudo。当当前用户对包管理器没有写入权限时需在命令前加sudo例如sudo apt install git bash。安装完成后可快速验证版本是否满足要求bash --version git --version确认 Bash 版本 ≥3.2.48、Git 版本 ≥1.7.7.2即可满足 asdf 0.16.0 的核心依赖门槛。三、插件依赖超越核心的第二层依赖核心依赖之外asdf 文档特别提醒了一类容易被忽略的依赖插件在使用前可能需要安装额外的程序。官方原文韩文版明确指出asdf 플러그인은 사용하기 전에 추가적인 프로그램의 설치가 필요할 수 있습니다. 플러그인을 설치하기 전에 플러그인의 문서를 읽고 해당 플러그인의 모든 의존성이 설치되어 있는지 확인하세요.即在安装插件之前请先阅读该插件的文档确认其全部依赖都已就绪。以韩文版 getting-started 中举例的asdf-nodejs插件为例它在不同操作系统上还需要如下额外依赖OS依赖安装命令Debianapt-get install dirmngr gpg curl gawkCentOS / Rocky Linux / AlmaLinuxyum install gnupg2 curl gawkmacOSbrew install gpg gawk文档进一步提示最好先安装依赖再安装插件因为部分插件带有安装后执行的钩子post-install hook依赖缺失会导致这些钩子运行异常。这一点与仓库源码的行为是吻合的asdf 的插件安装流程本身只负责通过 Git 克隆插件仓库见 internal/git/git.go 的Clone而插件后续的list-all、install回调会自行调用插件所需的外部程序。依赖是否满足完全取决于插件自身脚本因此插件文档才是判断依赖的权威来源。四、开发与 CI 环境中的依赖安装仓库实测脚本对于希望为 asdf 项目本身做开发、运行测试或构建的读者仓库提供了 scripts/install_dependencies.bash 一键依赖安装脚本它是 asdf 在 GitHub Actions CI 中使用的真实脚本可作为 Linux/macOS 环境依赖安装的完整参考Linux 分支通过apt-get安装curl parallel fish powershell含版本锁定--allow-downgrades并手动下载安装 Elvish 与 Nushell 的二进制到$HOME/bin最后将该目录追加到GITHUB_PATH。macOS 分支通过brew install coreutils parallel elvish fish nushell powershell安装全部依赖。通用部分从 .tool-versions根目录配置文件解析bats版本再用git clone --depth 1 --branch v$bats_version安装 bats-core 测试框架。注意该脚本设计为仅在 GitHub Actions 中运行开头会检查GITHUB_ACTIONS与RUNNER_OS环境变量未设置时直接退出。它面向的是asdf 全功能测试覆盖 Bash、ZSH、Fish、Elvish、Nushell、PowerShell 多种 shell 的兼容性测试并非普通用户安装 asdf 所需的最小依赖集——普通用户按第二节表格安装git与bash即可。另外bats本身也是通过 Git 克隆安装的再次印证了 Git 在整个 asdf 工具链包括其自身测试体系中的基础地位。五、安装后的验证与排错完成依赖与 asdf 本体安装后可通过以下方式验证环境type -a asdf asdf infotype -a asdf确认asdf可执行文件位于$PATH中韩文版 getting-started 中安装章节的标准验证手段。asdf info打印当前 asdf 版本与系统信息对应实现位于 internal/info/info.go。若出现git: command not found或插件克隆失败、版本解析报错等异常优先排查顺序应为系统是否安装 Git且版本 ≥1.7.7.2git --version系统是否安装 Bash且版本 ≥3.2.48bash --version若涉及具体插件如 Node.js、Ruby回到该插件仓库文档核对额外依赖gpg、curl、gawk 等若系统配置特殊确认安装依赖时是否已正确使用sudo。六、相关文档导航依赖问题往往与安装流程联动出现可进一步参阅仓库内以下韩文文档docs/ko-kr/manage/dependencies.md本文对应的原文英文版见 docs/manage/dependencies.mddocs/ko-kr/parts/install-dependencies-cmds.md各操作系统依赖安装命令表docs/ko-kr/guide/getting-started.md从依赖安装到插件、版本管理的完整上手流程docs/ko-kr/manage/configuration.mdasdf 配置文件说明如legacy_version_file等选项。总结而言asdf 0.16.0 的核心依赖极为精简——仅需满足版本门槛的 Bash 与 Git插件作为扩展层可能引入额外的程序依赖务必以插件文档为准而开发/测试环境则可复用 scripts/install_dependencies.bash 获得完整的跨 shell 测试依赖。理解这三层依赖关系是顺利安装和使用 asdf 的第一步。【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 asdf 依赖清单与安装指南：核心版本要求、跨平台命令与插件依赖管理
asdf 依赖清单与安装指南核心版本要求、跨平台命令与插件依赖管理【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdfasdf 是一个可扩展的多运行时版本管理器支持 Ruby、Node.js、Elixir、Erlang 等众多语言工具的统一安装与版本切换。本文基于韩文版官方文档《의존성 목록》即 docs/ko-kr/manage/dependencies.md展开系统梳理 asdf 0.16.0 及更高版本对 Bash 与 Git 的版本要求、各操作系统下的依赖安装命令、插件层额外的依赖注意事项并结合本仓库源码如 internal/git/git.go、scripts/install_dependencies.bash说明这些依赖在 asdf 运行链路中的实际作用。读完后你将能够针对自己的操作系统准确、完整地安装 asdf 所需的全部依赖并懂得如何排查插件层面的依赖缺失问题。一、asdf 核心依赖与版本要求asdf 本身core在运行时只依赖两个外部程序Bash版本不低于3.2.48Git版本不低于1.7.7.2需要特别强调的是这份依赖清单是针对 asdf 0.16.0 及以上版本的。如果使用的是更早版本的 asdf可能还需要安装额外的依赖——因此文档明确指出旧版本的 asdf 需要额外的依赖原文이전 버전의 asdf는 추가적인 의존성이 필요합니다。建议升级到 0.16.0 或更高版本以获得最精简的依赖集合。提示本仓库当前 version.txt 中记录的版本为0.15.0而韩文版 getting-started 中以v0.20.0为例演示构建与安装依赖清单以官方文档声明的 0.16.0 为适用前提。为什么核心依赖恰好是 Bash 与 Git从源码结构可以清晰地看到这两项依赖的用途Git 承担了插件与插件索引仓库的全部版本控制操作。internal/git/git.go 是 asdf 对 Git 仓库操作的核心封装其Repoer接口定义了Clone、Head、RemoteURL、Update四个操作分别对应插件安装clone、查询当前提交、读取远端地址、拉取更新。具体实现直接调用系统git命令行例如// Clone installs a plugin via Git func (r Repo) Clone(pluginURL, ref string) error { cmdStr : []string{git, clone, --depth, 1, pluginURL, r.Directory} // ... _, stderr, err : exec(cmdStr) // ... }更新插件时同样通过git fetch --prune --update-head-ok与git checkout --force组合完成见 internal/git/git.go。Head()则使用git rev-parse HEAD获取当前提交。由此可见asdf 的插件机制本质上建立在系统 Git 之上——安装、升级插件都要调用git可执行文件因此 Git 是 asdf 不可或缺的运行依赖。Bash 则支撑了插件脚本生态。asdf 插件本身由 Bash 脚本编写测试目录 test/fixtures 下的dummy_plugin等即为此类插件的示例版本解析、安装回调和 shim 模板等执行链路都依赖 Bash 解释器。从构建依赖角度go.mod 中虽然引入了github.com/go-git/go-git/v5库但从当前 internal/git/git.go 的实现看实际仓库操作仍通过execute.New(git, ...)调用系统 Git 命令这也印证了文档asdf 自身必须安装 Git的要求并非虚设。二、按操作系统安装依赖的命令如果目标机器上尚未安装 Bash 或 Git文档提供了各主流操作系统/包管理器对应的安装命令。下表完整罗列与 docs/ko-kr/parts/install-dependencies-cmds.md 中include引入的内容一致操作系统包管理器命令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 系的安装命令都是同时安装git与bash两个包。macOS 系Homebrew 命令额外安装了coreutils——这是为了让 GNU 风格的核心工具可用因为 macOS 自带的 BSD 工具集与部分脚本的 GNU 行为存在差异Spack面向 HPC/科研环境的包管理器同样提供coreutils git bash。关于sudo文档特别注明根据系统配置可能需要sudo。当当前用户对包管理器没有写入权限时需在命令前加sudo例如sudo apt install git bash。安装完成后可快速验证版本是否满足要求bash --version git --version确认 Bash 版本 ≥3.2.48、Git 版本 ≥1.7.7.2即可满足 asdf 0.16.0 的核心依赖门槛。三、插件依赖超越核心的第二层依赖核心依赖之外asdf 文档特别提醒了一类容易被忽略的依赖插件在使用前可能需要安装额外的程序。官方原文韩文版明确指出asdf 플러그인은 사용하기 전에 추가적인 프로그램의 설치가 필요할 수 있습니다. 플러그인을 설치하기 전에 플러그인의 문서를 읽고 해당 플러그인의 모든 의존성이 설치되어 있는지 확인하세요.即在安装插件之前请先阅读该插件的文档确认其全部依赖都已就绪。以韩文版 getting-started 中举例的asdf-nodejs插件为例它在不同操作系统上还需要如下额外依赖OS依赖安装命令Debianapt-get install dirmngr gpg curl gawkCentOS / Rocky Linux / AlmaLinuxyum install gnupg2 curl gawkmacOSbrew install gpg gawk文档进一步提示最好先安装依赖再安装插件因为部分插件带有安装后执行的钩子post-install hook依赖缺失会导致这些钩子运行异常。这一点与仓库源码的行为是吻合的asdf 的插件安装流程本身只负责通过 Git 克隆插件仓库见 internal/git/git.go 的Clone而插件后续的list-all、install回调会自行调用插件所需的外部程序。依赖是否满足完全取决于插件自身脚本因此插件文档才是判断依赖的权威来源。四、开发与 CI 环境中的依赖安装仓库实测脚本对于希望为 asdf 项目本身做开发、运行测试或构建的读者仓库提供了 scripts/install_dependencies.bash 一键依赖安装脚本它是 asdf 在 GitHub Actions CI 中使用的真实脚本可作为 Linux/macOS 环境依赖安装的完整参考Linux 分支通过apt-get安装curl parallel fish powershell含版本锁定--allow-downgrades并手动下载安装 Elvish 与 Nushell 的二进制到$HOME/bin最后将该目录追加到GITHUB_PATH。macOS 分支通过brew install coreutils parallel elvish fish nushell powershell安装全部依赖。通用部分从 .tool-versions根目录配置文件解析bats版本再用git clone --depth 1 --branch v$bats_version安装 bats-core 测试框架。注意该脚本设计为仅在 GitHub Actions 中运行开头会检查GITHUB_ACTIONS与RUNNER_OS环境变量未设置时直接退出。它面向的是asdf 全功能测试覆盖 Bash、ZSH、Fish、Elvish、Nushell、PowerShell 多种 shell 的兼容性测试并非普通用户安装 asdf 所需的最小依赖集——普通用户按第二节表格安装git与bash即可。另外bats本身也是通过 Git 克隆安装的再次印证了 Git 在整个 asdf 工具链包括其自身测试体系中的基础地位。五、安装后的验证与排错完成依赖与 asdf 本体安装后可通过以下方式验证环境type -a asdf asdf infotype -a asdf确认asdf可执行文件位于$PATH中韩文版 getting-started 中安装章节的标准验证手段。asdf info打印当前 asdf 版本与系统信息对应实现位于 internal/info/info.go。若出现git: command not found或插件克隆失败、版本解析报错等异常优先排查顺序应为系统是否安装 Git且版本 ≥1.7.7.2git --version系统是否安装 Bash且版本 ≥3.2.48bash --version若涉及具体插件如 Node.js、Ruby回到该插件仓库文档核对额外依赖gpg、curl、gawk 等若系统配置特殊确认安装依赖时是否已正确使用sudo。六、相关文档导航依赖问题往往与安装流程联动出现可进一步参阅仓库内以下韩文文档docs/ko-kr/manage/dependencies.md本文对应的原文英文版见 docs/manage/dependencies.mddocs/ko-kr/parts/install-dependencies-cmds.md各操作系统依赖安装命令表docs/ko-kr/guide/getting-started.md从依赖安装到插件、版本管理的完整上手流程docs/ko-kr/manage/configuration.mdasdf 配置文件说明如legacy_version_file等选项。总结而言asdf 0.16.0 的核心依赖极为精简——仅需满足版本门槛的 Bash 与 Git插件作为扩展层可能引入额外的程序依赖务必以插件文档为准而开发/测试环境则可复用 scripts/install_dependencies.bash 获得完整的跨 shell 测试依赖。理解这三层依赖关系是顺利安装和使用 asdf 的第一步。【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考