WezTerm在Mac上需手动下载安装、配置shell别名、创建Lua配置文件、安装Nerd Fonts并启用GPU渲染与QuickSelect功能。具体步骤包括：从GitHub下载.dmg或用Homebrew安装；添加alias至~/.zshrc；新建~/.config/wezterm/wezterm.lua；安装JetBrainsMono Nerd Font；在配置中设置font、font_size、enable_csd等参数；最后添加Ctrl+Shift+Q快捷键启用正则QuickSelect。
如果您希望在Mac系统上部署WezTerm终端并完成深度自定义配置，可能面临下载失败、命令不可用、配置文件不生效或字体渲染异常等问题。以下是解决此问题的步骤：
一、下载与安装WezTerm
Mac平台无法直接通过App Store获取WezTerm，需依赖GitHub发布页或Homebrew进行获取；若网络受限，压缩包直连方式更可靠，可避免因缺少代理导致的下载中断。
1、访问官方发布页：https://github.com/wez/wezterm/releases，查找最新macOS版本（如wezterm-20260315-154837-d9a1e5a2.dmg）。
2、若GitHub访问缓慢，使用加速工具（如http://toolwa.com/github/）粘贴发布页URL，下载.dmg镜像后双击挂载并拖入Applications文件夹。
3、终端执行以下命令验证是否可调用（若提示command not found，则需配置别名）：
brew install --cask wez/wezterm/wezterm
二、配置命令行可执行入口
WezTerm.app默认不注册全局命令，需手动为wezterm创建shell别名或符号链接，否则无法从终端直接启动或调用其子命令（如wezterm cli）。
1、打开终端，编辑zsh配置文件：vi ~/.zshrc
2、在文件末尾新增一行（路径需与实际安装位置一致）：alias wezterm="/Applications/WezTerm.app/Contents/MacOS/wezterm"
3、保存后执行重载命令：source ~/.zshrc
4、验证是否生效：wezterm --version应输出类似20260315-154837-d9a1e5a2的版本号
三、初始化配置目录与主配置文件
WezTerm启动时默认读取~/.config/wezterm/wezterm.lua，该文件不存在则启用内置默认配置；必须手动创建目录结构并放置合法Lua配置，否则所有自定义设置（如字体、主题、快捷键）均无效。
1、创建标准配置路径：mkdir -p ~/.config/wezterm/
2、进入该目录：cd ~/.config/wezterm/
3、使用curl下载社区常用基础配置（确保已安装curl）：curl -O https://raw.githubusercontent.com/wez/wezterm/main/sample-config/wezterm.lua
4、若下载失败，可手动新建文件：touch wezterm.lua，再用nano或vscode打开并粘贴最小可用配置（含local wezterm = require 'wezterm'及return config结构）
四、启用GPU加速与字体渲染优化
WezTerm在macOS上默认启用Metal后端，但若出现文字模糊、光标闪烁异常或高DPI缩放错位，需显式指定渲染策略与等宽字体，并确保字体具备Powerline/Glyph支持。
1、确认已安装Nerd Fonts（如JetBrainsMono Nerd Font）：
前往https://github.com/ryanoasis/nerd-fonts/releases下载JetBrainsMono.zip，解压后双击安装全部ttf文件
2、编辑~/.config/wezterm/wezterm.lua，在config = { ... }块内添加或修改以下字段：font = wezterm.font("JetBrainsMono Nerd Font", {weight = "Bold"}),font_size = 12.5,enable_csd = false,use_fancy_tab_bar = false
3、保存后重启WezTerm，按Cmd+Shift+P调出命令面板，输入Reload Configuration即时生效
五、启用多面板工作流与QuickSelect增强
WezTerm支持分屏与跨面板文本提取，但需启用对应功能开关并绑定快捷键；默认未开启QuickSelect正则匹配模式，无法高效筛选基因ID、坐标或错误码等生物信息学关键字段。
1、在wezterm.lua中定位到config.keys = { ... }区域（若无则新建），添加以下映射：{ key = "Q", mods = "CTRL|SHIFT", action = wezterm.action{QuickSelect = { regex = "[A-Z]{2,}[0-9]+|[chr][0-9]+:[0-9]+-[0-9]+" } } },
2、为分屏操作添加快捷键（示例：垂直分割）：{ key = "D", mods = "CTRL|SHIFT", action = wezterm.action.SplitVertical = { domain = "CurrentPaneDomain" } },
3、保存配置，重新加载；在终端中运行BWA比对后，按Ctrl+Shift+Q即可高亮匹配所有类似chr1:12345-12400或ENSG00000123456格式的文本段
