POLOXUE's BLOG

POLOXUE's BLOG

28 Sep 2023

终端环境：iTerm2

视频版本，没有文章详细：

我想大部分程序员在平时的工作中都是离不开终端，特别是如果你的系统是 MacOS 或 Linux 的话，终端的地位更是遥遥领先。

本系列的目标是介绍如何基于 iTerm2、zsh、oh-my-zsh（包括高效插件）、高效 shell 命令，甚至将计划基于 Tmux 和 Neovim 搭建我的日常终端环境。

本文是搭建我的终端环境系列中的第一篇，首先将介绍第一个必不可可少的工具终端 - iTerm2，Mac 上的终端神器。

前言介绍

我将主要介绍如何安装与配置 iTerm2，安装成功后，会带着一起体验的一些能力。

首先，iTerm2 是一款终端软件，它是 macOS 下默认终端 Terminal 的替代品。每次拿到新电脑，或者因某种原因重装系统，我首先要做的就是下载 iTerm2 来替换默认的终端 terminal。

iTerm2 vs 默认 Terminal

为什么要用 iTerm2 替换默认的系统终端呢？这总要一些原因吧。

首先，iTerm2 相较于 Terminal 的优势就是，它更加美观，相对于默认终端，iTerm2 支持真彩，而且，你可以在终端显示图片，甚至是 gif 动图。

其他功能如分屏能力、颜色面板主题配置、搜索等肯定是基本能力，但毫无疑问，比默认终端体验更友好，更优秀。还有，快捷键的定制性更强。展示静态图片和 GIF 也不在话下。

iTerm2 还支持如 python 编程控制，可实现自动换背景，布局管理等各种自动化能力。

还有，与 iTerm2 与 zsh 相结合体验更佳，zsh 部分会在后面慢慢介绍。

废话不多说，接下来，让我们进入安装使用流程。

下载安装

首先是安装，可通过 iTerm2 官网 下载或者 MacOS 中 brew 安装，我将以 brew 安装为例。

如果还未安装 brew，安装命令：

1

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 iterm2，命令如下：

1

brew install --cask iterm2

等待执行完成，即安装完毕。

颜色面板主题

iTerm2 支持自定义颜色面板 color preset 设置。

首先，以 material design colors 为例，介绍如何安装设置。

安装命令，如下所示：

1

curl -Ls https://raw.githubusercontent.com/MartinSeeler/iterm2-material-design/master/material-design-colors.itermcolors > /tmp/material-design-colors.itermcolors && open /tmp/material-design-colors.itermcolors

如果成功执行，将会在 iTerm2 的 Preferences （使用快捷键 CMD+, 可快捷打开）-> Color 下的 “Color Presets” 中新增一条颜色面板选项，即 “material-design-color”。选中确认即可将 iTerm2 默认的颜色面板修改为 “material-design-color”。

上面的命令是通过 curl 下载配色文件，通过 open 打开直接安装。其实，稍微麻烦一点做法是，可通过设置面板 import 导入下载的后缀为 itermcolors 的文件。

如下所示：

想有更多的选择，再安装两个配色方案：

安装 Snazzy：

1

curl -Ls https://raw.githubusercontent.com/sindresorhus/iterm2-snazzy/main/Snazzy.itermcolors > /tmp/Snazzy.itermcolors && open /tmp/Snazzy.itermcolors

安装 Dracula:

1

curl -Ls https://raw.githubusercontent.com/dracula/iterm/master/Dracula.itermcolors > /tmp/Dracula.itermcolors && open /tmp/Dracula.itermcolors

查看 Color Presets 面板，如下所示：

选择一款你钟爱的配色，保存。

如果还没有满意的，可以从 Iterm2-color-schemes 查找更多配色方案

主题切换效果，如下所示：

如何使用

打开 ‘iTerm2’，快速使用体验一下吧。

分屏功能

如下图所示，“CommandL+d” 垂直分屏，“Command+D” 水平分屏。

当然，这个快捷键是可以配置的，因为这两个快捷键趋势不够便捷。我们打开它的快捷键配置，进入 Preferences -> Keys -> key Binds 即可开始设置快捷键键。

其中的红色框内容可用于设置如何水平和垂直分割屏幕：

  • SHIFT+COMMAND+| -> 水平切片 split horizontally；
  • SHIFT+COMMAND+- -> 水平切片 split horizontally；

其中的蓝色框区域可用于设置 vim 风格的上下左右分屏切换：

  • COMMAND+h：向左选中
  • COMMAND+j：向下选中
  • COMMAND+k：向上选中
  • COMMAND+l：向右选中

对于习惯使用 vim，但不是每个任务都有打开 tmux + vim 组合的时候，这个快捷键的设置就是效率神器啊。

分屏最大化

如下图所示，“Shift+Command+Enter” 分屏最大化。

再次 “Shift+Command+Enter” 恢复分屏。

如果你习惯于在终端工作，那么分屏功能肯定是日常使用最多的能力了吧。如上的三分屏幕效果，左边座位代码编辑区域、右上方用于调试或运行代码，下面可用于其他一些测试或者运行命令区域。

支持搜索

相对于 通过 “Command+f” 开启搜索框：

iTerm2 的搜索能力更强大，可以在搜索框下拉仔细检查下它能力。诸如默认的 smartcase 模式、大小写敏感和不敏感模式、正则。可能你觉得这些不是很正常吗？俗话说，没有对比就没有伤害，如果你和系统默认的终端对比下就知道它的优秀之处了。

其他

iTerm2 是真彩 256 colors，这才让我们可以在 iTerm2 将 neovim 打造成媲美 vscode 的 IDE。

真彩测试，如下所示；

获取脚本，访问脚本地址。

IDE 效果：

还有，我们可以直接在 iTerm2 查看图片，静态图片和 GIF 都是支持的。

我现在就希望有一天终端支持内置浏览器，实现我 360 度无死角不用离开终端的梦想。我知道有一些文本 browser，如 w3m、lynx、links 等等。还有 browsh 这样的利用 firefox 渲染，终端展示的图形化支持的浏览器。但体验都巨差，无法真正意义上替换浏览器。

我的梦啊！

高级能力 Python API

这部分主要介绍 iTerm2 提供的 Python API，利用它，带你实现一些不一样的能力。我将演示两个案例，分别是背景图自动更换和分屏创建自动化。

自动更换背景图

编程枯燥无味，想通过背景图为枯燥生活提供一些趣味。假设，我们要设计一个脚本，给终端一小时自动更好一个背景图。

假设我的壁纸图片都在 ~/Public/images/beauties 目录下。

实现下这个代码，如下所示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

import iterm2
import random
import os
import asyncio
import sys


# 替换背景图片的函数
async def change_background(session, image_path):
    # 获取当前会话的配置文件
    profile = await session.async_get_profile()

    # 设置透明度，值在0（完全透明）到1（完全不透明）之间
    await profile.async_set_transparency(0.2)  # 设置为50%透明度
    # 设置背景图像位置
    await profile.async_set_background_image_location(image_path)


async def main(connection):
    app = await iterm2.async_get_app(connection)
    window = app.current_terminal_window

    if window is None:
        return

    session = window.current_tab.current_session

    # 获取脚本参数提供的目录
    directory = sys.argv[1] if len(sys.argv) > 1 else "."
    if not os.path.isdir(directory):
        raise ValueError(f"Provided path {directory} is not a directory")

    while True:  # 创建无限循环以定期更换背景
        # 获取目录中的所有图片文件
        image_files = [
            os.path.join(directory, f)
            for f in os.listdir(directory)
            if f.lower().endswith((".png", ".jpg", ".jpeg", ".tiff", ".bmp", ".gif"))
        ]

        if image_files:
            # 随机选择一张图片
            chosen_image = os.path.abspath(random.choice(image_files))
            # 调用函数更改背景
            await change_background(session, chosen_image)
        else:
            print(f"No images found in directory {directory}")

        # 等待一个小时
        await asyncio.sleep(3600)


iterm2.run_until_complete(main)

代码中提供了注释说明，不熟悉 Python 直接考虑即可，命令的接收参数是存放图片的目录。

定时能力，我们是通过 sleep(3600) 实现每小时随机更换背景图片。特别说明，不要用 crontab，因为存在环境上下文问题，crontab 无法知道 iTerm2 的存在。

这个脚本可以放在 sh 的启动脚本中，如 bashrc、zshrc 等，这取决于你用什么 shell。我们只要将其设置为后台常驻的形式运行，

1

python random-bg.py your-images-directory &

我假设将它设置为 1 秒换一次图片，效果如下所示：

布局自动化

如果你用 tmux 的话，可能知道有些布局管理工具，如 tmuxifier 和 tmuxinator， 可自动创建布局。其实，只用 iTerm2，同样可实现这样的功能。

因为 iTerm2 的 Python API 提供了创建分屏的接口。

示例代码如下所示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import iterm2

async def main(connection):
    app = await iterm2.async_get_app(connection)
    window = app.current_terminal_window
    if window is None:
        print("No current window")
        return

    session = window.current_tab.current_session
    # 垂直分屏
    await session.async_split_pane(vertical=True)
    # 如果你想要水平分屏，将vertical参数设置为False
    # await session.async_split_pane(vertical=False)

iterm2.run_until_complete(main)

重点就是那句 await session.async_split_pane(vertical=True)，执行这个角度会自动进行左右分屏，即垂直分屏。

演示效果如下：

假设，你想自定义一些布局的话，如前面提到这个效果，如下所示：

我们来实现一个命令自动创建这个效果。

需求详细描述，iTerm2 自动创建三个 pane 的布局，左边 pane 用于通过 vim 命令打开指定目录（IDE 写代码)，右边上下两个 pane 中，上面的 pane 执行 go run *.go 命令，下面的 pane 创建清空等待输入。

编写这样一个脚本来实现这个流程，代码如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

import iterm2
import sys


async def main(connection):
    # 获取要打开的目录作为参数
    directory = sys.argv[1] if len(sys.argv) > 1 else "."

    app = await iterm2.async_get_app(connection)
    window = app.current_terminal_window

    if window is not None:
        # 创建左边的pane
        left_session = window.current_tab.current_session
        await left_session.async_send_text(f"cd {directory}\n")
        await left_session.async_send_text("vim\n")

        # 创建右边的pane
        # 右上的pane保持空白
        top_right_session = await left_session.async_split_pane(vertical=True)
        await top_right_session.async_send_text("\clear\n")
        await top_right_session.async_send_text("go run *.go\n")

        # 在右下的pane执行go run *.go
        bottom_right_session = await top_right_session.async_split_pane(vertical=False)
        await bottom_right_session.async_send_text("\clear\n")

    else:
        print("No current window")

iterm2.run_until_complete(main)

就不啰嗦代码逻辑了，非常简单。

命令效果，如下所示：

Python API 的使用就演示这两个案例。想了解它的更多能力，可直接查看它的官方文档，访问 iTemr2 Python API Documentation。

最后

本文重点介绍了 iTerm2 的安装、颜色面板的配置，还有体验其核心的能力，最有趣的部分是通过 iTerm2 的 Python API 能力，实现了一些自动化任务（自动更换背景和布局管理），提高趣味性和效率。

博文地址：终端环境：iTerm2