直接换 zsh + oh-my-zsh 可行，但须验证安装、用 chsh 设默认 shell 并新开终端确认 $SHELL；国内推荐 Gitee 镜像安装 oh-my-zsh；启用 autosuggestions 和 syntax-highlighting 插件需手动克隆并注意加载顺序；agnoster 主题需 Powerline 字体和 UTF-8 locale 支持。
直接换 zsh + oh-my-zsh 是可行的，但别跳过验证和重载步骤——很多人卡在 chsh -s /bin/zsh 后没重启终端或没检查 $SHELL，结果还在用 bash 却以为配置生效了。
确认系统已安装 zsh 并设为默认 shell
先查有没有 zsh：which zsh 或 zsh --version。Ubuntu/Debian 通常自带，CentOS/RHEL 可能需要手动装：sudo yum install -y zsh（CentOS 7/8）或 sudo dnf install -y zsh（Fedora/CentOS Stream）。
关键一步不是装完就完事，得改默认 shell：chsh -s $(which zsh)。注意：chsh 不会立即生效，必须新开一个终端窗口，再运行 echo $SHELL 确认输出是 /bin/zsh 或 /usr/bin/zsh；如果还是 /bin/bash，说明没生效，别往下走。
常见错误：
-
chsh: PAM authentication failure：说明当前用户没权限改 shell，试试加sudo chsh -s $(which zsh) $USER（部分系统允许） - 终端没刷新导致
source ~/.zshrc报错找不到文件：先确认新终端里ls -la ~/.zshrc是否存在
用官方脚本安装 oh-my-zsh，优先走国内镜像
原始命令 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" 在国内大概率超时或卡住。直接换 Gitee 镜像更稳：sh -c "$(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh)"。
安装过程会提示是否把 zsh 设为默认 shell——此时你已经手动设过了，选 n 避免重复操作引发冲突。安装完，~/.oh-my-zsh/ 目录和 ~/.zshrc 就有了。
注意：install.sh 默认会执行 source ~/.zshrc，但它不保证你的终端环境变量完整。建议手动跑一次：source ~/.zshrc，再输 echo $ZSH 看是否输出 ~/.oh-my-zsh。
启用 zsh-autosuggestions 和 zsh-syntax-highlighting 插件
这两个插件不是 oh-my-zsh 自带的，得手动 clone 到 $ZSH_CUSTOM/plugins/ 下（默认是 ~/.oh-my-zsh/custom/plugins/）：
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestionsgit clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
然后编辑 ~/.zshrc，找到 plugins=(...) 行，把插件名加进去，比如：plugins=(git zsh-autosuggestions zsh-syntax-highlighting)。
⚠️ 顺序有影响：zsh-syntax-highlighting 必须放在最后，否则高亮可能失效；zsh-autosuggestions 的建议颜色默认是灰色，在深色终端里几乎看不见，可加一行：ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=10'（绿色）提升可读性。
改完必须重载：source ~/.zshrc。如果报错 command not found: compdef，说明插件加载太早，检查是否漏了 source $ZSH/oh-my-zsh.sh 这行——它必须在 plugins=() 之后、插件 source 之前。
中文乱码、主题不显示、agnoster 主题报错
agnoster 主题依赖 Powerline 字体，不装字体就会满屏 符号或路径不显示。别只改 ZSH_THEME="agnoster"，还得：
- 下载并安装一个支持 Powerline 的字体，比如
Fira Code或JetBrainsMono Nerd Font（去 Nerd Fonts 下） - 在终端设置里把字体改成刚装的那个（GNOME Terminal：偏好设置 → 字体；iTerm2：Profiles → Text → Font）
- 确保 locale 支持 UTF-8：
locale | grep -i utf应该有LC_ALL=en_US.UTF-8或类似输出；没有就加到~/.zshrc开头：export LC_ALL=en_US.UTF-8
如果改完还是乱码，别急着换主题——先关掉所有插件，只留 plugins=(git)，再 source ~/.zshrc。能显示说明是插件冲突或字体问题；不能显示，大概率是 locale 或终端字体没配对。
最常被忽略的一点：agnoster 要求 POWERLEVEL9K 才能发挥全部能力，但它是独立项目，oh-my-zsh 原生不带。真要深度定制，得单独装 powerlevel10k，而不是硬啃 agnoster 的坑。
