Mac上Ruby 3.2.1安装问题：Shell Integration未启用

第一步：确认当前使用的Shell #

先执行命令查看当前shell类型：

echo $SHELL

输出如果是/bin/zsh，说明用的是Zsh（Mac默认Shell）；如果是/bin/bash，则为Bash。

第二步：配置Shell集成 #

针对Zsh #

1. 打开Zsh配置文件：

nano ~/.zshrc

2. 在文件末尾添加以下两行内容：

. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash

3. 保存并退出编辑器（按Ctrl+O → 回车确认保存 → Ctrl+X退出）
4. 让配置立即生效：

source ~/.zshrc

针对Bash #

1. 打开Bash配置文件（优先用~/.bash_profile，若无则用~/.bashrc）：

nano ~/.bash_profile

2. 在文件末尾添加同样的两行内容：

. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash

3. 保存并退出编辑器，执行命令让配置生效：

source ~/.bash_profile

第三步：验证配置 #

执行以下命令确认asdf已正常集成：

asdf --version

若能输出asdf版本号，再尝试切换Ruby版本：

asdf global ruby 3.2.1

最后检查Ruby版本是否切换成功：

ruby -v

注意：如果你的asdf不是默认安装在$HOME/.asdf路径下（比如通过Homebrew安装），需要将上述配置中的路径替换为实际安装路径，例如Homebrew安装的路径为/usr/local/opt/asdf/libexec/asdf.sh。

内容的提问来源于stack exchange，提问作者Panamaniac507