Zsh脚本中局部变量赋值意外输出至标准输出的问题排查

你遇到的核心问题是在全局作用域（非函数内部）使用了local命令，这是Zsh的特殊行为导致的。

问题根源 #

local命令的设计初衷是在函数内部创建局部变量，当你在脚本的顶层全局作用域使用它时，Zsh会认为这是一个非预期的用法：

1. 它会在stderr输出警告（比如local: can only be used in a function），但你用2>/dev/null把这部分内容屏蔽了，所以没看到。
2. 同时，这个错误用法会触发Zsh将变量的赋值操作打印到stdout，也就是你看到的zmodule=bar/baz、zurl=https://github.com/bar/baz这些行。

你的猜测“local仅在函数内生效”是完全正确的，而赋值语句被打印正是在函数外误用local的直接副作用。

解决方案 #

这里有两种简单的修复方式，任选其一即可：

方案1：用函数包裹逻辑（推荐）

把整个脚本的核心逻辑放到一个函数里，让local处于函数作用域内，这样就符合它的设计用途，不会再打印赋值语句：

#!/usr/bin/env zsh

load_zmodules() {
  local zmodules=(foo bar/baz)
  local zmodule
  for zmodule (${zmodules}); do
    local zurl zname
    zname=${zmodule##*/}
    case ${#zmodule//[^\/]/} in
      0) zurl="https://github.com/foo/${zmodule}" ;; 
      1) zurl="https://github.com/${zmodule}" ;; 
    esac
    print "${zurl} ${zname}"
  done
}

# 执行函数
load_zmodules

方案2：移除所有local关键字

如果不需要限制变量作用域，直接去掉所有local，因为脚本顶层的变量本来就是全局作用域，这样也不会触发赋值打印：

#!/usr/bin/env zsh

zmodules=(foo bar/baz)
zmodule
for zmodule (${zmodules}); do
  zurl zname
  zname=${zmodule##*/}
  case ${#zmodule//[^\/]/} in
    0) zurl="https://github.com/foo/${zmodule}" ;; 
    1) zurl="https://github.com/${zmodule}" ;; 
  esac
  print "${zurl} ${zname}"
done

验证效果 #

运行修改后的脚本，不管用哪种方案，你都会得到预期的输出：

$ source ./example.zsh 2>/dev/null
https://github.com/foo/foo foo
https://github.com/bar/baz baz

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