tmux为何向SHELLOPTS添加posix？z命令失效如何解决？

问题现象 #

常用的目录跳转工具z命令在tmux会话中突然失效，执行z时触发语法错误：

-sh: command substitution: line 1: syntax error near unexpected token `<`
-sh: command substitution: line 1: ` < <( _z_dirs ) \awk -v t="$(\date +%s)" -v list="$list" -v typ="$typ" -v q="$fnd" -F"|" ''

检查环境变量发现，tmux会话内的$SHELLOPTS包含posix选项：

❯ echo $SHELLOPTS
braceexpand:emacs:hashall:histexpand:history:interactive-comments:monitor:posix

退出tmux或重新启动bash后，$SHELLOPTS不再包含posix，z命令恢复正常：

❯ echo $SHELLOPTS
braceexpand:emacs:hashall:histexpand:history:interactive-comments:monitor

注：个人dotfiles中未主动配置posix相关选项。

成因分析 #

1. tmux启动shell的模式触发POSIX模式：tmux默认可能会以POSIX兼容模式启动shell，或者你的shell被tmux调用为sh——bash在被命名为sh或通过--posix参数启动时，会自动开启POSIX模式，将posix加入SHELLOPTS。
2. POSIX模式禁用bash扩展特性：z命令的实现依赖bash的非POSIX扩展语法（比如进程替换< <(...)），而POSIX模式下bash会禁用这类特性，直接导致z命令执行时触发语法错误。

解决办法 #

方法1：修改tmux配置，强制启动标准bash #

在~/.tmux.conf中添加以下配置，指定tmux启动标准bash：

set-option -g default-command "/bin/bash"

如果需要保留交互式shell特性，可添加-i参数：

set-option -g default-command "/bin/bash -i"

保存配置后，执行tmux source ~/.tmux.conf重载配置，重启tmux会话即可生效。

方法2：在bash启动脚本中关闭POSIX模式 #

如果无法修改tmux配置，可在~/.bashrc或~/.bash_profile中添加一行，强制关闭POSIX模式：

set +o posix

这样无论shell以何种模式启动，都会自动关闭POSIX选项，确保z命令依赖的bash特性可用。

方法3：检查并修正tmux的shell配置 #

执行以下命令查看tmux当前的默认启动命令：

tmux show-option -g default-command

如果输出包含sh或--posix，直接修改为bash即可。

内容的提问来源于stack exchange，提问作者oligofren