如何在 .tmux.conf 中编写 if 语句为不同的 tmux 版本设置不同的选项？

Question

我有一个 .tmux.conf，我在安装了不同 tmux 版本的不同机器上使用它。

我想根据 tmux 版本设置不同的鼠标选项。 在一台机器上我有版本2.0 另一台2.1。

我不明白他的角色

if "[[(( $(tmux -V | cut -c 6-) < 2.1 ))]]" \
  "set -g mode-mouse on;" \
  "set -g mouse-resize-pane on;" \
  "set -g select-pane on;" \
  "set -g select-window on" "set -g mouse on"

当我获取文件时

$ tmux source-file .tmux.conf

我收到这条消息

.tmux.conf:12: unknown command: set -g mouse-resize-pane on

我运行它的机器版本为2.1，所以它不应该设置四个选项。

我想在运行 tmux 2.0 或更低版本时设置四个选项，或者在运行 tmux 2.1 时设置一个选项。

这个 bash 语句有效

$ tmux -V
tmux 2.1
$ if [[(( $(tmux -V | cut -c 6-) < 2.1 ))]];then echo $?;else echo $?;fi
1

Answer 1

基于@ericx's answer 和@thiagowfx's answer，我将以下内容放在一起，涵盖了从2.0 版开始的许多listed incompatibilties：

# Version-specific commands [grumble, grumble]
# See: https://github.com/tmux/tmux/blob/master/CHANGES
run-shell 'tmux setenv -g TMUX_VERSION $(tmux -V | \
                           sed -En "s/^tmux[^0-9]*([.0-9]+).*/\1/p")'


if-shell -b '[ "$(echo "$TMUX_VERSION < 2.1" | bc)" = 1 ]' " \
    set -g mouse-select-pane on; set -g mode-mouse on; \
    set -g mouse-resize-pane on; set -g mouse-select-window on; \
    set -g message-fg red; \
    set -g message-bg black; \
    set -g message-attr bright; \
    set -g window-status-bg default; \
    set -g window-status-fg default; \
    set -g window-status-current-attr bold; \
    set -g window-status-current-bg cyan; \
    set -g window-status-current-fg default; \
    set -g window-status-bell-fg red; \
    set -g window-status-bell-bg black; \
    set -g window-status-activity-fg white; \
    set -g window-status-activity-bg black"

# In version 2.1 "mouse" replaced the previous 4 mouse options
if-shell -b '[ "$(echo "$TMUX_VERSION >= 2.1" | bc)" = 1 ]' \
  "set -g mouse on"

# UTF8 is autodetected in 2.2 onwards, but errors if explicitly set
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.2" | bc)" = 1 ]' \
  "set -g utf8 on; set -g status-utf8 on; set -g mouse-utf8 on"

# bind-key syntax changed in 2.4 -- selection / copy / paste
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.4" | bc)" = 1 ]' " \
   bind-key -t vi-copy v   begin-selection; \
   bind-key -t vi-copy V   send -X select-line; \
   bind-key -t vi-copy C-v rectangle-toggle; \
   bind-key -t vi-copy y   copy-pipe 'xclip -selection clipboard -in'"

# Newer versions
if-shell -b '[ "$(echo "$TMUX_VERSION < 2.9" | bc)" = 1 ]' " \
   bind-key -T copy-mode-vi v   send -X begin-selection; \
   bind-key -T copy-mode-vi V   send -X select-line; \
   bind-key -T copy-mode-vi C-v send -X rectangle-toggle; \
   bind-key -T copy-mode-vi y   send -X copy-pipe-and-cancel 'xclip -selection clipboard -in'"

if-shell -b '[ "$(echo "$TMUX_VERSION >= 2.9" | bc)" = 1 ]' \
   "set -g message-style fg=red,bg=black; \
    set -g message-style bright; \
    set -g window-status-style          fg=default,bg=default; \
    set -g window-status-current-style  fg=default,bg=cyan,bold; \
    set -g window-status-bell-style     fg=red,bg=black; \
    set -g window-status-activity-style fg=white,bg=black"

我提出了一个关于tmux 的非向后兼容问题here 的问题。总结是tmux 开发者将不支持向后兼容性，也不会采用突出显示哪些版本包含重大更改的版本编号方案。 ?

我向support numeric comparators for %if 提出了一个问题，即implemented in v3.0。

Answer 2

if-shell 并不总是有效。相反，我使用一个 shell 脚本来加载正确版本的 tmux.conf：

在 .tmux.conf 中：

run-shell "bash ~/.tmux/verify_tmux_version.sh"

在 verify_tmux_version.sh 中：

#!/bin/bash

verify_tmux_version () {
    tmux_home=~/.tmux
    tmux_version="$(tmux -V | cut -c 6-)"

    if [[ $(echo "$tmux_version >= 2.1" | bc) -eq 1 ]] ; then
        tmux source-file "$tmux_home/tmux_2.1_up.conf"
        exit
    elif [[ $(echo "$tmux_version >= 1.9" | bc) -eq 1 ]] ; then
        tmux source-file "$tmux_home/tmux_1.9_to_2.1.conf"
        exit
    else
        tmux source-file "$tmux_home/tmux_1.9_down.conf"
        exit
    fi
}

verify_tmux_version

更多详情： https://gist.github.com/vincenthsu/6847a8f2a94e61735034e65d17ca0d66

Answer 3

这有点麻烦。 在 tmux 内（不依赖外部 shell 脚本）执行此操作的正确方法结合了 Vincent 和 jdloft 响应的特性。

tmux 中的if-shell 命令用作

if-shell [-bF] [-t target-pane] shell-command command [command]
               (alias: if)
    Execute the first command if shell-command returns success or the second command otherwise.  Before
    being executed, shell-command is expanded using the rules specified in the FORMATS section, including
    those relevant to target-pane.  With -b, shell-command is run in the background.

    If -F is given, shell-command is not executed but considered success if neither empty nor zero (after
         formats are expanded).

请注意，tmux shell-command 扩展将扩展 #{pane_current_path} 形式的变量，否则将不理会命令。

更重要的是，注意tmuxuses/bin/sh -c执行我们指定的shell命令。因此，命令must be POSIX compliant，因此[[ 形式的测试不能保证是可移植的。现代 Ubuntu 和 Debian 系统，例如，符号链接 /bin/sh 到 dash。

我们想要运行一个符合 POSIX 标准的 shell 命令来测试 tmux 版本并在找到所需版本时返回 0 (true)。

if-shell '[ $(echo "$(tmux -V | cut -d" " -f2) >= 2.1" | bc) -eq 1 ]' \
    'command if true' \
    'command if false'

例子：

if-shell '[ $(echo "$(tmux -V | cut -d" " -f2) >= 2.1" | bc) -eq 1 ]' \
    'set -g mouse on; set -g mouse-utf8 on' \
    'set -g mode-mouse on; set -g mouse-resize-pane on; set -g mouse-select-pane on; set -g mouse-select-window on' 

这正确地处理了我们正在做浮点运算的事实，所以bcis required。此外，不需要 if/then/else/fi 构造，因为 [ 运算符会自行生成真值。

一些笔记

• 继续到下一行的行不能有尾随 cmets，否则 tmux 将给出“未知命令”错误消息。
• “如果为 false 的命令”可以省略。
• 可以使用; 组合多个判断为真或假的命令
• 该命令使用/bin/sh -c 在底层shell 上运行。不保证使用 [[ 或其他非 POSIX 语法的其他方法有效。

编辑：此答案的先前版本使用 [[，它不适用于不使用 bash 的系统。替换为[ 解决了这个问题。

Answer 4

我还偶然发现了不同 tmux 版本中的配置不匹配。在查看了此处和 this related question on SuperUser 中的所有解决方案后，我实现了以下变体：

# Version-specific configuration can be placed in ~/.tmux/${TMUX_VERSION}/*.conf
run-shell "for conf in ~/.tmux/$(tmux -V | cut -d' ' -f2)/*.conf; do tmux source-file \"\$conf\"; done"

有了这个，版本特定的配置可以放入（多个）配置sn-ps中用于特定版本。这类似于@VincentHsu 的解决方案，但是：

• 它不需要外部 shell 脚本。
• 它不会分成固定的版本范围（... / 1.9 到 2.0 / 2.1 ...）。相反，可以使用（符号）链接在多个 tmux 版本之间共享配置 sn-p。
• 它不会对版本的单个文件名进行硬编码。通过为每个版本允许多个配置 sn-ps，部分可以在版本之间共享，而其他部分则保持版本特定。这应该提供最大的灵活性。
• 原始~/.tmux.conf 中只有一个配置元素。其他解决方案（例如来自 @TomHale 的解决方案）复制每个配置元素的版本测试。

Answer 5

在某些机器上，我使用双括号 ('[[') 语法得到了误报结果。所以我想出了一个使用 awk 的替代方案：

# Enable mouse for different versions of tmux
# (If 'awk' exits with status 0, 'if-shell' evaluates to true)
# tmux < v2.1:
if-shell "tmux -V | awk '{exit !($2 < \"2.1\")}'" \
    "setw -g mode-mouse on ; set -g mouse-select-pane on ; set -g mouse-resize-pane on ; set -g mouse-select-window on ;"
# tmux >= v2.1:
if-shell "tmux -V | awk '{exit !($2 >= \"2.1\")}'" \
    "set -g mouse on ;"

Answer 6

Tmux的if-shell可以用来查看ZSH版本。

[[ `tmux -V | cut -d' ' -f2` -lt 2.1 ]]

检查 tmux 版本是否大于或等于 2.1。使用它，我们可以根据 ZSH 版本设置您的鼠标命令。

if-shell "[[ `tmux -V | cut -d' ' -f2` -lt 2.1 ]]" \
    'set -g mode-mouse on; set -g mouse-resize-pane on; set -g mouse-select-pane on; set -g mouse-select-window on'

并为更高版本的 tmux 设置它：

if-shell "[[ `tmux -V | cut -d' ' -f2` -ge 2.1 ]]" \
    'set -g mouse on; set -g mouse-utf8 on'

Answer 7

我最近遇到了这个问题，我的解决方案是编写一个“tmux-older-than”脚本：

#! /bin/bash

TMUX_VERSION="$(tmux -V | cut -d" " -f2)"
test 1 -eq "$( echo "$TMUX_VERSION < $1" | bc)"

这使得 tmux.conf 更具可读性：

if-shell 'tmux-older-than 3.0' \
        'bind-key ^P swap-window -t -1' \
        'bind-key ^P swap-window -d -t -1'

Answer 8

当前的最新版本是2.9a，它摒弃了这里使用的许多直接比较。

我的替代方案使用sort -V，它在处理版本比较方面更加稳健。

编辑：评论者指出 sort -V 在 BSD sort 中不可用，例如在本机 OSX 上。然而，这仍然是一个解释不是纯数字版本的答案。

# ver >= 2.3
[ ! "$(printf "%s\n%s" "$TMUX_VERSION" "2.3" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

# ver > 2.3
[ ! "$(printf "%s\n%s" "$TMUX_VERSION" "2.4" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

# ver < 2.3
[ "$(printf "%s\n%s" "$TMUX_VERSION" "2.3" | sort -V | head -n1)" == "$TMUX_VERSION" ]' \
    "command"

Answer 9

我有这个配置很多年了。

• 支持tmux 2.4tmux 2.4atmux next-3.3等版本
• 没有bc 命令
• 支持 Cygwin、macOS 和 Linux

# Tmux version before 2.4
if-shell -b '[ `tmux -V | cut -d" " -f2 | tr -d " |\-|.|[:alpha:]"` -lt 24 ]' \
  'bind-key -t vi-copy v begin-selection; \
    bind-key -t vi-copy Q cancel; \
    bind-key -t vi-copy Enter cancel'

# Tmux version 2.4 onwards
if-shell -b '[ `tmux -V | cut -d" " -f2 | tr -d " |\-|.|[:alpha:]"` -ge 24 ]' \
  'bind-key -T copy-mode-vi C-w   send-keys -X cancel; \
bind-key -T copy-mode-vi C-u   send-keys -X halfpage-up; \
bind-key -T copy-mode-vi C-j   send-keys -X halfpage-down; \
bind-key -T copy-mode-vi C-l   send-keys -X select-line'

Answer 10

较新版本的 tmux 支持更简洁的 if 条件。以下适用于 tmux 3.2a 版：

if-shell '[ "$(tmux -V)" = "tmux 3.2a" ]' {
    set -g status-bg red
    set -g status-fg yellow
}

Answer 11

我已将建议的解决方案组合成一个可行的解决方案（在 tmux 1.8 和 2.7 上测试）：

run-shell "tmux setenv -g TMUX_VERSION $(tmux -V | cut -c 6-)"

if-shell -b '[[ "$TMUX_VERSION" < "2.6" ]]' \
  "bind w choose-tree -u"

if-shell -b '[[ "$TMUX_VERSION" < "2.2" ]]' \
  "set -g status-utf8 on"

Answer 12

这不是替代方案，而是对已接受答案的扩展 - （Tom Hale 的答案是最可靠和最完整的）。

为了减少 .tmux.conf 中的重复次数，您可以将 shell 测试字符串存储在 tmux 环境变量 (available since 0.8 in 2008) 中，并在运行时为 if-shell 插入它们：

# Use which sed pattern actually works in the accepted answers
run-shell 'tmux setenv -g TMUX_VERSION $(tmux -V | sed -En "...")'

# Setup condition checks
V33_GTE='[ "$(echo "$TMUX_VERSION >= 3.3" | bc)" = 1 ]' 
V33_LT='[ "$(echo "$TMUX_VERSION < 3.3" | bc)" = 1 ]'

# So on for other versions
# ...

### Example binding
# Toggle mouse
bind m set -g mouse on  \; display 'Mouse: ON'
bind M set -g mouse off \; display 'Mouse: OFF' 

# As of 3.1 you can annotate your keybindings
# As of 3.3 you can attach a note to existing bindings without setting the binding
# If running >= 3.3 , attach a note to the binding for `list-keys -N`

if "$V33_GTE" bind -N "Enable mouse mode" m
if "$V33_GTE" bind -N "Disable mouse mode" M

Answer 13

tmux 3.0a

# execute a tmux command if a shell-command succeeded
# if-shell '[[ -z "$SSH_CLIENT" ]]' \     # use test or [ , instead of [[
# if-shell "[ $HOST == 'redmi14-leo' ]"   # can't work don't know why

if-shell '[[ -z "$SSH_CLIENT" ]]' \
    'source-file ~/.tmux.remote.conf'