Zsh 安装与配置指导

一份完整的 zsh、Git Bash、Oh My Zsh 安装配置指南，助你打造高效美观的终端环境

什么是 zsh 和 Oh My Zsh

zsh 简介

zsh（Z Shell）是一款功能强大的 Unix/Linux shell，它是 bash 的增强版，提供了许多 bash 不具备的先进功能：

更强大的自动补全功能
拼写纠正和智能提示
丰富的主题和插件支持
更灵活的自定义配置
路径缩写和通配符扩展
共享命令历史

Oh My Zsh 简介

Oh My Zsh 是一个开源的、社区驱动的 zsh 配置管理框架，由 Robby Russell 创建。它是目前最流行的 zsh 配置工具之一，拥有：

300+ 可选插件：支持 Git、Docker、Node.js、Python、Kubernetes 等
140+ 精美主题：让终端焕然一新
自动更新工具：轻松保持与社区最新更新同步
2400+ 贡献者：活跃的社区持续维护和改进

官网：https://ohmyz.sh
GitHub：https://github.com/ohmyzsh/ohmyzsh

Linux/macOS 下安装 zsh

1. 安装基本工具

Ubuntu/Debian 系统

bash

# 更新软件源
sudo apt update && sudo apt upgrade -y

# 安装 zsh、git、curl
sudo apt install zsh git curl -y

CentOS/RHEL 系统

bash

sudo yum install zsh git curl -y

macOS 系统

macOS Catalina (10.15) 及更高版本已默认使用 zsh。如需安装或更新：

bash

# 使用 Homebrew 安装
brew install zsh

# 或者使用 MacPorts
sudo port install zsh

2. 验证安装

bash

zsh --version

3. 设置 zsh 为默认终端

bash

# 设置默认 shell 为 zsh（注意：不要使用 sudo）
chsh -s /bin/zsh

# 或者使用 which 命令获取 zsh 路径
chsh -s $(which zsh)

注意：设置完成后需要重新登录或重启终端才能生效。

Windows 下通过 Git Bash 安装 zsh

Windows 系统原生不支持 zsh，但可以通过 Git Bash（基于 MSYS2）来运行 zsh。

1. 安装 Git Bash

访问 Git 官网下载安装包：https://git-scm.com/downloads
运行安装程序，建议保持默认设置，包括安装路径
完成安装

2. 下载并安装 zsh

方式一：下载预编译的 ZIP 包（推荐）

下载已经解压好的 zsh ZIP 包，方便在 Windows 环境下直接使用：

下载地址：zsh-5.9-2-x86_64.pkg.zip

方式二：官网下载最新版

zsh 下载地址：https://packages.msys2.org/package/zsh
注意：下载的文件为 .zst 格式，需要安装 PeaZip 等解压软件

安装步骤

解压下载的 zsh 包，会得到两个目录：
- etc
- usr
将这两个目录复制到 Git 安装目录（默认为 C:\Program Files\Git）
如果提示文件冲突，选择覆盖即可

3. 设置 zsh 为默认终端

打开 Git Bash，执行以下命令：

bash

chsh -s $(which zsh)

或者手动编辑 ~/.bashrc 文件：

bash

vi ~/.bashrc

添加以下内容：

bash

# 方式一：该方式会导致vscode 终端Bash出现问题NPM SCRIPTS执行命令后无法看到日志。
if [ -t 1 ]; then
    exec zsh
fi


#方式二：如果已经执行过 zsh，则不再执行
if [ -n "$ZSH_EXECUTED" ]; then
    return
fi
export ZSH_EXECUTED=1

# 只在真正的交互式终端中切换，排除vscode 终端和非交互式环境
if [ -t 1 ] && [ -z "$TERM_PROGRAM" ] || [ "$TERM_PROGRAM" != "vscode" ]; then
    exec zsh
fi

vscode 采用默认的Git Bash, 在终端菜单中新增一个Oh My Zsh选项，通过该选项创建zsh终端窗口，在 settings.json 中添加以下配置：

json

"terminal.integrated.profiles.windows": {
    "PowerShell": {
      "source": "PowerShell",
      "icon": "terminal-powershell"
    },
    "Command Prompt": {
      "path": [
        "${env:windir}\\Sysnative\\cmd.exe",
        "${env:windir}\\System32\\cmd.exe"
      ],
      "args": [],
      "icon": "terminal-cmd"
    },
    "Git Bash": {
      "source": "Git Bash",
      "icon": "terminal-git-bash"
    },
    "Oh My Zsh": {
      "source": "Git Bash",
      "icon": "terminal-debian",
      "args": [
        "-c",
        "zsh"
      ]
    }
  }

Oh My Zsh 安装

安装方式

方式一：官方一键安装（需要良好的网络环境）

使用 curl：

bash

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

使用 wget：

bash

sh -c "$(wget -O- https://install.ohmyz.sh/)"

方式二：国内镜像加速（推荐国内用户使用）

使用 Gitee 镜像：

bash

sh -c "$(curl -fsSL https://gitee.com/pocmon/ohmyzsh/raw/master/tools/install.sh)"

或者使用 wget：

bash

sh -c "$(wget -O- https://gitee.com/pocmon/ohmyzsh/raw/master/tools/install.sh)"

方式三：手动下载安装脚本

下载安装脚本：

bash

curl -O -L https://mirror.ghproxy.com/https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh

编辑脚本，修改安装源（在仓库地址前添加 https://mirror.ghproxy.com/）：

bash

vi install.sh

将以下配置：

bash

REPO=${REPO:-ohmyzsh/ohmyzsh}
REMOTE=${REMOTE:-https://github.com/${REPO}.git}
BRANCH=${BRANCH:-master}

更改为：

bash

REPO=${REPO:-ohmyzsh/ohmyzsh}
REMOTE=${REMOTE:-https://mirror.ghproxy.com/https://github.com/${REPO}.git}
BRANCH=${BRANCH:-master}

执行安装脚本：

bash

sh install.sh

安装确认

安装过程中会提示是否使用 Oh My Zsh 的配置模板覆盖已有的 .zshrc，输入 Y 确认即可。

安装完成后，重新打开终端，你应该能看到 Oh My Zsh 的欢迎界面和新的主题样式。

Oh My Zsh 配置

Oh My Zsh 的所有配置都在 ~/.zshrc 文件中，通过编辑该文件可以自定义主题、插件等。

1. 配置主题

查看内置主题

Oh My Zsh 内置了 140+ 主题，可以在以下目录查看：

bash

cd ~/.oh-my-zsh/themes && ls

主题效果预览：Oh My Zsh Themes

修改主题

编辑 ~/.zshrc 文件：

bash

nano ~/.zshrc

找到 ZSH_THEME 配置项，修改为喜欢的主题：

bash

# 默认主题
ZSH_THEME="robbyrussell"

# 推荐主题
ZSH_THEME="ys"
ZSH_THEME="lukerandall"
ZSH_THEME="agnoster"

推荐主题：Powerlevel10k

Powerlevel10k 是目前最受欢迎的 Oh My Zsh 主题之一，具有高度可定制性和美观的界面。

安装步骤：

bash

# 克隆主题仓库
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# 国内用户可以使用 Gitee 镜像加速
git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

在 ~/.zshrc 中设置主题：

bash

ZSH_THEME="powerlevel10k/powerlevel10k"

重新加载配置后，Powerlevel10k 会自动引导你完成配置向导。

2. 使配置生效

修改配置后，执行以下命令使更改生效：

bash

source ~/.zshrc

常用插件推荐

Oh My Zsh 拥有 300+ 插件，以下是一些常用且实用的插件推荐。

内置插件（无需额外安装）

Oh My Zsh 已经内置了大量插件，位于 ~/.oh-my-zsh/plugins 目录：

插件名	功能描述
`git`	Git 别名和自动补全
`z`	目录快速跳转
`extract`	万能解压命令 `x`
`web-search`	命令行搜索引擎
`sudo`	双击 `Esc` 添加 `sudo`
`command-not-found`	命令未找到时提供安装建议
`colored-man-pages`	彩色的 man 手册页

第三方插件（需要手动安装）

1. zsh-autosuggestions（命令自动补全）

根据历史记录自动提示命令，按右键即可快速采用建议。

安装：

bash

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

国内加速：

bash

# 加速镜像 1
git clone https://github.moeyy.xyz/https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# 加速镜像 2
git clone https://gh.xmly.dev/https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

2. zsh-syntax-highlighting（语法高亮）

命令输入时实时校验语法，合法命令显示绿色，不合法显示红色。

安装：

bash

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

国内加速：

bash

git clone https://github.moeyy.xyz/https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

启用插件

编辑 ~/.zshrc 文件，找到 plugins 配置项：

bash

nano ~/.zshrc

修改为：

bash

# 基础配置
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

# 完整配置示例
plugins=(
    git
    zsh-autosuggestions
    zsh-syntax-highlighting
    z
    extract
    web-search
    colored-man-pages
    sudo
)

使配置生效：

bash

source ~/.zshrc

实用技巧

1. 从 bash 迁移配置

如果之前在 bash 中自定义了环境变量、别名等，可以手动迁移到 zsh：

bash

# 查看 bash 配置文件
cat ~/.bashrc

# 编辑 zsh 配置文件
nano ~/.zshrc

# 启动新的 zsh 配置
source ~/.zshrc

2. root 用户配置

配置好普通用户的 zsh 后，使用 sudo su 进入 root 用户可能仍然是 bash。建议为 root 用户也安装 Oh My Zsh：

bash

sudo su
sh -c "$(curl -fsSL https://install.ohmyz.sh/)"

建议使用不同的主题以便区分：

bash

# root 用户的 ~/.zshrc 配置
ZSH_THEME="ys"
plugins=(git zsh-autosuggestions zsh-syntax-highlighting z extract web-search)

3. 配置本地代理

如果配置了本地代理，可以在 ~/.zshrc 中添加代理函数：

bash

# 为 curl、wget、git 等设置代理
proxy() {
    export ALL_PROXY="socks5://127.0.0.1:1089"
    export all_proxy="socks5://127.0.0.1:1089"
}

# 取消代理
unproxy() {
    unset ALL_PROXY
    unset all_proxy
}

使用时只需在终端输入 proxy 即可启用代理，unproxy 取消代理。

4. WSL 配置本地代理

在 WSL 中需要获取宿主机的 IP 地址：

bash

host_ip=$(cat /etc/resolv.conf | grep "nameserver" | cut -f 2 -d " ")

proxy() {
    export ALL_PROXY="http://$host_ip:10811"
    export all_proxy="http://$host_ip:10811"
}

unproxy() {
    unset ALL_PROXY
    unset all_proxy
}

5. 手动更新 Oh My Zsh

如果自动更新提示被误触关闭，可以手动更新：

bash

upgrade_oh_my_zsh

6. 卸载 Oh My Zsh

如需卸载，执行以下命令：

bash

uninstall_oh_my_zsh

按照提示输入 Y 确认，Oh My Zsh 会自动恢复原来的 zsh 配置。

7. Windows Terminal 配置

Windows Terminal 是一个现代化的终端应用程序，支持多标签页和自定义配置。

安装：从 Microsoft Store 搜索安装，或访问官方文档
配置默认启动 Git Bash：
- 打开 Windows Terminal 设置
- 将默认配置文件设置为 Git Bash
- 可选：设置默认启动目录

8. IDE 终端配置

在 VS Code、IntelliJ IDEA 等 IDE 中，可以将默认终端设置为 Git Bash：

VS Code：

打开设置 (Ctrl+,)
搜索 terminal.integrated.defaultProfile.windows
选择 Git Bash

IntelliJ IDEA：

File → Settings → Tools → Terminal
将 Shell path 修改为 Git Bash 路径（如 C:\Program Files\Git\bin\bash.exe）

总结

通过本文的指导，你应该已经成功安装并配置了 zsh 和 Oh My Zsh。以下是关键步骤回顾：

Linux/macOS：直接安装 zsh 并设置为默认 shell
Windows：通过 Git Bash + zsh 包实现
Oh My Zsh：使用官方或国内镜像安装
主题配置：推荐 Powerlevel10k 或 ys 主题
插件推荐：zsh-autosuggestions、zsh-syntax-highlighting、z、extract

现在，享受你的全新终端体验吧！

参考资源

本文内容整理自网络资源，仅供学习参考。

Zsh 安装与配置指导 ​

目录 ​

什么是 zsh 和 Oh My Zsh ​

zsh 简介 ​

Oh My Zsh 简介 ​

Linux/macOS 下安装 zsh ​

1. 安装基本工具 ​

Ubuntu/Debian 系统 ​

CentOS/RHEL 系统 ​

macOS 系统 ​

2. 验证安装 ​

3. 设置 zsh 为默认终端 ​

Windows 下通过 Git Bash 安装 zsh ​

1. 安装 Git Bash ​

2. 下载并安装 zsh ​

方式一：下载预编译的 ZIP 包（推荐） ​

方式二：官网下载最新版 ​

安装步骤 ​

3. 设置 zsh 为默认终端 ​

Oh My Zsh 安装 ​

安装方式 ​

方式一：官方一键安装（需要良好的网络环境） ​

方式二：国内镜像加速（推荐国内用户使用） ​

方式三：手动下载安装脚本 ​

安装确认 ​

Oh My Zsh 配置 ​

1. 配置主题 ​

查看内置主题 ​

修改主题 ​

推荐主题：Powerlevel10k ​

2. 使配置生效 ​

常用插件推荐 ​

内置插件（无需额外安装） ​

第三方插件（需要手动安装） ​

1. zsh-autosuggestions（命令自动补全） ​

2. zsh-syntax-highlighting（语法高亮） ​

启用插件 ​

实用技巧 ​

1. 从 bash 迁移配置 ​

2. root 用户配置 ​

3. 配置本地代理 ​

4. WSL 配置本地代理 ​

5. 手动更新 Oh My Zsh ​

6. 卸载 Oh My Zsh ​

7. Windows Terminal 配置 ​

8. IDE 终端配置 ​

总结 ​

参考资源 ​

Zsh 安装与配置指导

目录

什么是 zsh 和 Oh My Zsh

zsh 简介

Oh My Zsh 简介

Linux/macOS 下安装 zsh

1. 安装基本工具

Ubuntu/Debian 系统

CentOS/RHEL 系统

macOS 系统

2. 验证安装

3. 设置 zsh 为默认终端

Windows 下通过 Git Bash 安装 zsh

1. 安装 Git Bash

2. 下载并安装 zsh

方式一：下载预编译的 ZIP 包（推荐）

方式二：官网下载最新版

安装步骤

3. 设置 zsh 为默认终端

Oh My Zsh 安装

安装方式

方式一：官方一键安装（需要良好的网络环境）

方式二：国内镜像加速（推荐国内用户使用）

方式三：手动下载安装脚本

安装确认

Oh My Zsh 配置

1. 配置主题

查看内置主题

修改主题

推荐主题：Powerlevel10k

2. 使配置生效

常用插件推荐

内置插件（无需额外安装）

第三方插件（需要手动安装）

1. zsh-autosuggestions（命令自动补全）

2. zsh-syntax-highlighting（语法高亮）

启用插件

实用技巧

1. 从 bash 迁移配置

2. root 用户配置

3. 配置本地代理

4. WSL 配置本地代理

5. 手动更新 Oh My Zsh

6. 卸载 Oh My Zsh

7. Windows Terminal 配置

8. IDE 终端配置

总结

参考资源