Shell脚本多行字符串拆分问题及ShellCheck合规疑问

问题背景 #

引入ShellCheck后，原脚本的多行字符串拆分逻辑出现冲突：原代码用IFS=$'\n' comment_lines=($comment)按换行拆分评论为数组，ShellCheck要求给$comment加引号，但加引号后数组仅保留第一行；改用IFS=$'\n' read -r -a comment_lines <<< $comment也存在同样问题。我们需要找到符合ShellCheck规范且能正确拆分多行的方案，而非忽略提示。

合规解决方案 #

绝对不要忽略ShellCheck提示——不加引号的$comment会触发单词拆分和路径名展开（比如评论里的*会被替换成当前目录文件列表），存在安全风险。推荐两种合规方案：

方案1：使用mapfile（Bash 4.0+ 支持）

这是最简洁的方式，直接将多行输入按换行拆分到数组，同时自动去除每行末尾的换行符：

mapfile -t comment_lines <<< "$comment"

方案2：兼容Bash 3.x的循环读取（比如老版本macOS）

如果需要兼容低版本Bash，用while read循环逐行读取并添加到数组：

comment_lines=()
# IFS= 保留行首空格，-r 禁止反斜杠转义
while IFS= read -r line; do
    comment_lines+=("$line")
done <<< "$comment"

修改后的核心代码 #

替换原代码中拆分多行的部分，以mapfile为例：

...
# 替换原第1行，实现合规的多行拆分
mapfile -t comment_lines <<< "$comment"
# 2
for comment_line in "${comment_lines[@]}"; do

    # 3
    IFS=' ' read -r -a comment_line_words <<< "$comment_line"
    # 4
    for ((i = 0; i < ${#comment_line_words[@]}; i++)); do

        # 处理@提及、构建段落等逻辑

    done
done
...

效果验证 #

当调用脚本传入多行评论时：

comment-issue --issue-id [id] --comment "This is a comment
That spans multiple lines
and allows me to mention @(Coworker Name)"

comment_lines数组会正确包含3个元素，对应每一行内容，后续的单词拆分和@提及提取逻辑可以正常运行。

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