Windows 上安装 Zsh

在 Windows 环境下，通过 Git Bash 安装并配置 Zsh、Oh My Zsh 以及 Powerlevel10k 主题

PS: git bash 显示 MinGW-w64, 是基于 MSYS2 的裁剪版不包含 pacman wget 等工具

PS: 如果要共享 MSYS2 的工具, 可以安装 MSYS2 后把 bin 目录添加到 PATH 环境变量中

1
2
nano ~/.zshrc
export PATH="/c/msys64/usr/bin:$PATH"

参考: https://gist.github.com/glenkusuma/7d7df65a89e485ec2f4690fdc88fffd6

准备工作

确保 Git 已更新到最新版本，以保证与 Zsh 软件包的兼容性

Git 官网下载

1
2
git version 2.53.0.windows.1
zsh 5.9 (x86_64-pc-cygwin)

下载并安装 Zsh

Git Bash 默认不带 Zsh，需要手动从 MSYS2 镜像中获取并安装

下载 Zsh 软件包

访问 MSYS2 软件包仓库，下载后缀为 .pkg.tar.zst 的文件

tar.zst, 需要下载 7zip-zstd 解压

复制 usr etc 目录覆盖到 C:\Program Files\Git\

设置环境变量 (PATH)

1
2
vim ~/.zshrc
export PATH="/mingw64/bin:/usr/bin:/bin:$PATH"

zsh 默认启动

方法一:

修改 bash.bashrc

Git Bash 启动时会读取 C:\Program Files\Git\etc\bash.bashrc为了让它能加载用户的 .bashrc，在文件末尾添加：

1
2
# Get user bash configuration ~/.bashrc
source ~/.bashrc;

修改 ~/.bashrc

在你的用户主目录（~ 或 C:\Users\你的用户名）下创建或修改 .bashrc 文件，添加以下逻辑以自动跳转到 Zsh：

1
2
3
4
# Launch Zsh
if [ -t 1 ]; then
exec zsh
fi

方法二:

直接启动 zsh

1
"C:/Program Files/Git/usr/bin/zsh.exe" -i -l

如果报错 /etc/profile.d/git-prompt.sh:56: command not found: shopt

1
2
mv /etc/profile.d/git-prompt.sh /etc/profile.d/git-prompt.sh.bak
curl -o /etc/profile.d/git-prompt.sh https://raw.githubusercontent.com/git/git/master/contrib/completion/git-prompt.sh

最新的 git-prompt.sh 支持zsh

vscode

1
2
3
4
5
6
7
"terminal.integrated.profiles.windows": {
  "zsh": {
    "path": "C:\\Program Files\\Git\\usr\\bin\\zsh.exe",
    "args": ["--login", "-i"]
  }
},
"terminal.integrated.defaultProfile.windows": "zsh",

安装主题/插件

~~安装 on my zsh + p10k~~

直接安装 zimfw, 显示效果更佳(p10k主题拖拽窗口时会渲染异常)

工具链

遇到的问题

ln -s 软链接变成复制

在~/.zshrc文件里面加上

1
export MSYS="winsymlinks:nativestrict"

打开 git bash 需要管理员打开

windows 路径无法识别: 用双引号包裹

准备工作

下载并安装 Zsh

安装 主题/插件

工具链

遇到的问题

安装主题/插件