asdf 依赖安装完全指南Linux 与 macOS 主流包管理器命令详解【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf导读asdf 是一个可扩展的版本管理器支持 Ruby、Node.js、Elixir、Erlang 等数十种开发工具但其自身运行时几乎只依赖git与bash两个基础组件。本文以仓库韩文文档 docs/ko-kr/parts/install-dependencies-cmds.md 中的依赖安装命令表为核心骨架结合英文原版 docs/parts/install-dependencies-cmds.md、依赖说明页 及 Git 操作源码系统讲解 asdf 的依赖组成、各包管理器下的安装命令、版本要求与安装后的验证方法帮助你在任何 Linux 或 macOS 环境中一次装齐 asdf 运行所需的最小依赖集。一、asdf 为什么需要这些依赖asdf 的核心设计是以 Git 仓库为插件分发载体。它通过git clone拉取插件仓库再以git fetch/git checkout更新插件这一点可以从仓库源码 internal/git/git.go 中直接看到Clone方法执行git clone --depth 1 pluginURL directoryUpdate方法则组合执行git fetch --prune --update-head-ok与git checkout --force。也就是说没有gitasdf 连安装插件的第一步都无法完成这就是官方文档 docs/ko-kr/parts/install-dependencies.md 中asdf 主要需要git这一论断的源码级依据。此外 asdf 的命令行核心与插件脚本均基于 Bash因此bash同样是硬性依赖。而 macOS 自带的系统bash长期停留在 3.2 版本、且缺少部分 GNU 工具所以在 macOS 上还需要通过包管理器补充coreutilsGNU 核心工具集。二、各操作系统 / 包管理器安装命令总表以下表格直接继承自 docs/ko-kr/parts/install-dependencies-cmds.md内容与英文版 docs/parts/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为方便中文读者直接复制执行上表对应的命令统一整理如下操作系统包管理器安装命令LinuxAptitudeDebian / Ubuntu 系sudo apt install git bashLinuxDNFFedora / RHEL 系sudo dnf install git bashLinuxPacmanArch Linux 系sudo pacman -S git bashLinuxZypperopenSUSE 系sudo zypper install git bashmacOSHomebrewbrew install coreutils git bashmacOSSpackspack install coreutils git bash要点说明Linux 各系只需git与bash两个包官方文档标注这是一个**非穷尽non-exhaustive**的命令列表某些工具的依赖可能在后续安装步骤中被自动解决。macOS额外安装了coreutils。这是因为 asdf 及其插件脚本依赖部分 GNU coreutils 工具而 macOS 默认的 BSD 工具集行为与之存在差异Homebrew 安装的coreutils会以g前缀如greadlink、gstat提供 GNU 版本。表格中 Linux 行未写sudo因为是否需要用sudo完全取决于你的系统配置——如果你的用户对包管理器有执行权限则无需提权否则请在命令前加上sudo。这与 docs/ko-kr/parts/install-dependencies.md 及 docs/manage/dependencies.md 中的提示一致。三、依赖的最低版本要求如果你的机器上已经安装了git与bash请核对版本。官方 依赖说明页 明确给出了 asdf 0.16.0 及以上版本的最低依赖版本依赖最低版本要求Bash3.2.48Git1.7.7.2该页面同时注明该版本清单适用于 asdf 0.16.0 及更高版本更早版本的 asdf 还有额外的依赖项。因此如果你使用的是旧版 asdf请同时参考对应旧版文档中的额外依赖说明对于新版 asdf只要满足上表版本即可无需为 asdf 核心安装额外的语言运行时——asdf 本体是 Go 编写的单一二进制从 go.mod 可以看到其模块路径为github.com/asdf-vm/asdf核心命令实现位于 cmd/ 目录运行时并不依赖 Ruby 或 Node.js。⚠️ 注意区分以上版本要求是asdf 核心的要求。各插件可能有自己额外的依赖例如asdf-nodejs需要dirmngr gpg curl gawk等安装插件前请阅读对应插件仓库的文档并确认其依赖已就绪详见 docs/manage/dependencies.md。四、安装依赖后的验证依赖装好后建议做以下两步验证确认环境就绪验证 Git 与 Bash 可用git --version bash --version | head -n 1在安装 asdf 之后验证二进制已进入$PATHtype -a asdftype输出中第一行应指向你放置asdf二进制的目录如果第一行指向的是别的位置说明安装步骤未正确完成需要检查二进制放置目录是否在$PATH中且顺序靠前。这一步在 韩文入门指南 的下载预编译二进制与从源码构建两种安装方式中均有强调源码构建流程可参考 Makefile 中的make目标。五、扩展CI 环境中如何安装依赖对于需要自动化验证 asdf 行为的持续集成场景仓库提供了现成的依赖安装脚本 scripts/install_dependencies.bash。该脚本只能在 GitHub Actions 中运行要求设置GITHUB_ACTIONS与RUNNER_OS环境变量其行为与本文主题对应如下Linux下通过apt-get安装curl parallel fish powershell并通过下载预编译二进制的方式安装elvish与nushellmacOS下则统一通过brew install coreutils parallel elvish fish nushell powershell安装——注意这里同样包含了coreutils印证了上文macOS 需要 coreutils的结论脚本随后使用git clone --depth 1从.tool-versions文件读取版本并安装bats-core测试框架再次体现了git在 asdf 生态中的基础设施地位。该脚本的思路可以迁移到你自己的 CI 流水线先用系统包管理器安装git bash再按需安装各插件的运行时与测试工具。六、进一步阅读依赖说明页asdf 核心与插件依赖的权威说明韩文入门指南安装 asdf 后的完整上手流程配置$PATH、shims、自动补全等Git 操作实现源码asdf 如何用 git 完成插件的克隆与更新CI 依赖安装脚本自动化环境下的依赖安装参考实现英文依赖命令表 与 安装依赖说明片段本文命令表的英文原版出处【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
asdf 依赖安装完全指南：Linux 与 macOS 主流包管理器命令详解
asdf 依赖安装完全指南Linux 与 macOS 主流包管理器命令详解【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf导读asdf 是一个可扩展的版本管理器支持 Ruby、Node.js、Elixir、Erlang 等数十种开发工具但其自身运行时几乎只依赖git与bash两个基础组件。本文以仓库韩文文档 docs/ko-kr/parts/install-dependencies-cmds.md 中的依赖安装命令表为核心骨架结合英文原版 docs/parts/install-dependencies-cmds.md、依赖说明页 及 Git 操作源码系统讲解 asdf 的依赖组成、各包管理器下的安装命令、版本要求与安装后的验证方法帮助你在任何 Linux 或 macOS 环境中一次装齐 asdf 运行所需的最小依赖集。一、asdf 为什么需要这些依赖asdf 的核心设计是以 Git 仓库为插件分发载体。它通过git clone拉取插件仓库再以git fetch/git checkout更新插件这一点可以从仓库源码 internal/git/git.go 中直接看到Clone方法执行git clone --depth 1 pluginURL directoryUpdate方法则组合执行git fetch --prune --update-head-ok与git checkout --force。也就是说没有gitasdf 连安装插件的第一步都无法完成这就是官方文档 docs/ko-kr/parts/install-dependencies.md 中asdf 主要需要git这一论断的源码级依据。此外 asdf 的命令行核心与插件脚本均基于 Bash因此bash同样是硬性依赖。而 macOS 自带的系统bash长期停留在 3.2 版本、且缺少部分 GNU 工具所以在 macOS 上还需要通过包管理器补充coreutilsGNU 核心工具集。二、各操作系统 / 包管理器安装命令总表以下表格直接继承自 docs/ko-kr/parts/install-dependencies-cmds.md内容与英文版 docs/parts/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为方便中文读者直接复制执行上表对应的命令统一整理如下操作系统包管理器安装命令LinuxAptitudeDebian / Ubuntu 系sudo apt install git bashLinuxDNFFedora / RHEL 系sudo dnf install git bashLinuxPacmanArch Linux 系sudo pacman -S git bashLinuxZypperopenSUSE 系sudo zypper install git bashmacOSHomebrewbrew install coreutils git bashmacOSSpackspack install coreutils git bash要点说明Linux 各系只需git与bash两个包官方文档标注这是一个**非穷尽non-exhaustive**的命令列表某些工具的依赖可能在后续安装步骤中被自动解决。macOS额外安装了coreutils。这是因为 asdf 及其插件脚本依赖部分 GNU coreutils 工具而 macOS 默认的 BSD 工具集行为与之存在差异Homebrew 安装的coreutils会以g前缀如greadlink、gstat提供 GNU 版本。表格中 Linux 行未写sudo因为是否需要用sudo完全取决于你的系统配置——如果你的用户对包管理器有执行权限则无需提权否则请在命令前加上sudo。这与 docs/ko-kr/parts/install-dependencies.md 及 docs/manage/dependencies.md 中的提示一致。三、依赖的最低版本要求如果你的机器上已经安装了git与bash请核对版本。官方 依赖说明页 明确给出了 asdf 0.16.0 及以上版本的最低依赖版本依赖最低版本要求Bash3.2.48Git1.7.7.2该页面同时注明该版本清单适用于 asdf 0.16.0 及更高版本更早版本的 asdf 还有额外的依赖项。因此如果你使用的是旧版 asdf请同时参考对应旧版文档中的额外依赖说明对于新版 asdf只要满足上表版本即可无需为 asdf 核心安装额外的语言运行时——asdf 本体是 Go 编写的单一二进制从 go.mod 可以看到其模块路径为github.com/asdf-vm/asdf核心命令实现位于 cmd/ 目录运行时并不依赖 Ruby 或 Node.js。⚠️ 注意区分以上版本要求是asdf 核心的要求。各插件可能有自己额外的依赖例如asdf-nodejs需要dirmngr gpg curl gawk等安装插件前请阅读对应插件仓库的文档并确认其依赖已就绪详见 docs/manage/dependencies.md。四、安装依赖后的验证依赖装好后建议做以下两步验证确认环境就绪验证 Git 与 Bash 可用git --version bash --version | head -n 1在安装 asdf 之后验证二进制已进入$PATHtype -a asdftype输出中第一行应指向你放置asdf二进制的目录如果第一行指向的是别的位置说明安装步骤未正确完成需要检查二进制放置目录是否在$PATH中且顺序靠前。这一步在 韩文入门指南 的下载预编译二进制与从源码构建两种安装方式中均有强调源码构建流程可参考 Makefile 中的make目标。五、扩展CI 环境中如何安装依赖对于需要自动化验证 asdf 行为的持续集成场景仓库提供了现成的依赖安装脚本 scripts/install_dependencies.bash。该脚本只能在 GitHub Actions 中运行要求设置GITHUB_ACTIONS与RUNNER_OS环境变量其行为与本文主题对应如下Linux下通过apt-get安装curl parallel fish powershell并通过下载预编译二进制的方式安装elvish与nushellmacOS下则统一通过brew install coreutils parallel elvish fish nushell powershell安装——注意这里同样包含了coreutils印证了上文macOS 需要 coreutils的结论脚本随后使用git clone --depth 1从.tool-versions文件读取版本并安装bats-core测试框架再次体现了git在 asdf 生态中的基础设施地位。该脚本的思路可以迁移到你自己的 CI 流水线先用系统包管理器安装git bash再按需安装各插件的运行时与测试工具。六、进一步阅读依赖说明页asdf 核心与插件依赖的权威说明韩文入门指南安装 asdf 后的完整上手流程配置$PATH、shims、自动补全等Git 操作实现源码asdf 如何用 git 完成插件的克隆与更新CI 依赖安装脚本自动化环境下的依赖安装参考实现英文依赖命令表 与 安装依赖说明片段本文命令表的英文原版出处【免费下载链接】asdfExtendable version manager with support for Ruby, Node.js, Elixir, Erlang more项目地址: https://gitcode.com/GitHub_Trending/as/asdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
![Task Plan: [Brief Description]](http://pic.xiahunao.cn/yaotu/Task Plan: [Brief Description])
