POSIX Shell函数名与函数体间加注释是否存在兼容性问题？

这种写法完全符合POSIX Shell标准，不会影响脚本的可移植性，也没有已知的主流POSIX兼容Shell会对此报错。

依据POSIX规范的解释 #

POSIX对Shell函数定义的语法规定为：

fname() compound-command [io-redirect ...]

其中compound-command可以是{ list ; }形式。Shell在解析时，会忽略()和{之间的所有空白字符（包括换行）以及注释——因为注释本身就是Shell会跳过的内容，不会被视为语法的一部分。你的写法本质上是在函数定义的语法允许的空白区域插入了注释，完全合规。

已验证的兼容Shell #

目前主流的POSIX兼容Shell都支持这种写法：

• Bash
• Dash
• Ksh（包括ksh93等分支）
• Zsh（在POSIX模式下同样兼容）

你提到的ShellCheck无报错、Dash/Bash正常运行的情况，也侧面印证了这种写法的合规性——ShellCheck的规则是严格遵循POSIX和主流Shell规范的。

无已知兼容性问题 #

目前没有公开记录的主流POSIX Shell会对这种写法产生解析错误或运行异常。只要你的脚本目标是遵循POSIX标准的Shell，这种注释写法可以放心使用。

内容的提问来源于stack exchange，提问作者Vlastimil Burián