Zsh Installer

Zsh + Oh My Zsh Installer

Overview

在 Linux 系统上安装和配置 Zsh + Oh My Zsh，统一团队开发环境。包括 agnoster 主题、git 插件、NVM 集成和自定义颜色方案。

When to Use This Skill

• 在新 VM 或服务器上初始化 shell 环境
• 用户要求安装 zsh 或 oh-my-zsh
• 需要统一的终端配置
• 诊断 zsh 或 oh-my-zsh 相关问题

Prerequisites

• Ubuntu/Debian 系统 (apt-get)
• sudo 权限
• 网络连接 (下载 Oh My Zsh)

Quick Start

一键安装

# 1. 安装 zsh
sudo apt-get update && sudo apt-get install -y zsh

# 2. 安装 Oh My Zsh (非交互模式)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

# 3. 设置 zsh 为默认 shell
sudo chsh -s $(which zsh) $(whoami)

Installation Workflow

Step 1: 安装 Zsh

sudo apt-get update && sudo apt-get install -y zsh

验证安装:

zsh --version
# 预期: zsh 5.9 (x86_64-ubuntu-linux-gnu) 或更高

Step 2: 安装 Oh My Zsh

# 非交互安装，不自动切换 shell
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

注意: --unattended 参数避免交互提示，适合脚本化安装。

Step 3: 配置 .zshrc

安装完成后，写入标准配置:

cat > ~/.zshrc << 'ZSHRC_EOF'
# Path to your Oh My Zsh installation.
export ZSH="$HOME/.oh-my-zsh"

# Theme: agnoster (需要 Powerline 字体)
ZSH_THEME="agnoster"

# Plugins
plugins=(git)

# Agnoster theme: custom color scheme
AGNOSTER_GIT_CLEAN_BG=yellow
AGNOSTER_GIT_CLEAN_FG=black

source $ZSH/oh-my-zsh.sh

# gLinux 性能优化: 禁用 VCS prompt 检查
# gLinux 的 FUSE 文件系统导致 git/bzr/hg 状态检查每次 ~450ms
# 检测方法: gLinux 的 $HOME 以 /usr/local/google/home/ 开头
if [[ "$HOME" == /usr/local/google/home/* ]]; then
  prompt_git() { :; }
  prompt_bzr() { :; }
  prompt_hg() { :; }
fi

# Claude Code PATH
export PATH="$HOME/.local/bin:$PATH"

# NVM (如果已安装)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
ZSHRC_EOF

Step 4: 设置默认 Shell

sudo chsh -s $(which zsh) $(whoami)

Step 5: 验证安装

# 验证默认 shell
echo $SHELL
# 预期: /usr/bin/zsh

# 验证 Oh My Zsh
ls ~/.oh-my-zsh/oh-my-zsh.sh && echo "Oh My Zsh OK"

# 验证主题
grep 'ZSH_THEME' ~/.zshrc
# 预期: ZSH_THEME="agnoster"

Configuration Details

主题: agnoster

agnoster 是一个信息丰富的 Powerline 风格主题，显示:

• 用户名和主机名
• 当前目录
• Git 分支和状态
• 返回值指示

自定义颜色:

# Git clean 状态使用黄色背景 + 黑色文字
AGNOSTER_GIT_CLEAN_BG=yellow
AGNOSTER_GIT_CLEAN_FG=black

插件: git

默认启用 git 插件，提供常用 git 别名:

• ga = git add
• gc = git commit
• gco = git checkout
• gd = git diff
• gl = git pull
• gp = git push
• gst = git status

环境变量

Troubleshooting

问题: gLinux 上每次敲回车响应慢 (~450ms)

原因: gLinux 使用 Google 内部分布式文件系统（FUSE 挂载），文件操作走网络 RPC。agnoster 主题的 prompt_git/prompt_bzr/prompt_hg 每次渲染 prompt 都要遍历目录树检查 VCS 状态。

解决方案: 在 source $ZSH/oh-my-zsh.sh 之后覆盖 VCS prompt 函数为空函数：

source $ZSH/oh-my-zsh.sh
# 必须放在 source 之后，否则会被 oh-my-zsh 覆盖回去
prompt_git() { :; }
prompt_bzr() { :; }
prompt_hg() { :; }

同时将 plugins 设为空：plugins=()

效果: prompt 渲染从 ~450ms 降到 ~12ms。

注意: 普通 GCP VM（ext4 磁盘）无此问题，不需要此优化。

问题: agnoster 主题显示乱码

原因: 缺少 Powerline 字体

解决方案:

# 安装 Powerline 字体
sudo apt-get install -y fonts-powerline

或手动安装:

git clone https://github.com/powerline/fonts.git --depth=1
cd fonts && ./install.sh
cd .. && rm -rf fonts

问题: Oh My Zsh 安装失败

诊断:

# 检查 curl 是否可用
which curl || sudo apt-get install -y curl

# 检查 git 是否可用
which git || sudo apt-get install -y git

问题: chsh 失败

解决方案:

# 确保 zsh 在 /etc/shells 中
grep -q "$(which zsh)" /etc/shells || echo "$(which zsh)" | sudo tee -a /etc/shells

# 再次尝试
sudo chsh -s $(which zsh) $(whoami)

问题: 新终端没有加载 zsh

解决方案:

# 检查当前 shell
echo $SHELL

# 如果不是 zsh，手动设置
sudo chsh -s /usr/bin/zsh $(whoami)

# 重新登录或手动启动 zsh
exec zsh

Verification Checklist

安装完成后的验证清单:

echo "=== Zsh + Oh My Zsh 验证 ==="
echo "1. Zsh version: $(zsh --version)"
echo "2. Default shell: $SHELL"
echo "3. Oh My Zsh: $(test -d ~/.oh-my-zsh && echo 'installed' || echo 'NOT installed')"
echo "4. Theme: $(grep 'ZSH_THEME=' ~/.zshrc | head -1)"
echo "5. Plugins: $(grep 'plugins=' ~/.zshrc | head -1)"