如何在Bash脚本中写入含双引号单引号的变量到CSV文件？

问题背景 #

我在编写Bash脚本时遇到了一个问题：要将包含双引号（"）、单引号（'）的变量值写入CSV文件，但直接拼接字符串会触发Shell语法错误。

示例变量：

• username: my-name@abc.com
• name: my-name
• password: j50z54"#7b'y'/3l7H%7

直接用以下脚本写入时：

echo -e "username,password,name" >> abc.csv
echo -e "$username,$password,$name" >> abc.csv

会抛出错误：

line 2: unexpected EOF while looking for matching `"'
line 3: syntax error: unexpected end of file

原因是变量中的双引号和单引号干扰了Shell的语法解析。

已尝试的无效方法 #

方法1：手动转义特殊字符 #

要求将变量值中的双引号和单引号用反斜杠转义，再用双引号包裹，比如password需要改为"j50z54\"#7b\'y\'/3l7H%7"。这种方法能生成正确CSV，但我无法修改变量源格式（password来自Azure DevOps变量组，通过$(password)获取）。

方法2：带转义的Here-Document #

使用\EOF关闭变量替换的Here-Document写法：

username=my-name@abc.com
name=my-name
cat >> abc.csv << \EOF
Username,Password,Name
$username,j70z38"#7k'y'/3l7H%9,$name
EOF

结果文件中直接输出了变量名，没有替换为实际值。

最优解决方案 #

方案1：自定义CSV转义函数（推荐） #

按照CSV标准规范处理字段：若字段包含逗号、双引号或换行，就用双引号包裹字段，同时将字段内的双引号替换为两个双引号（这是CSV的标准转义方式，而非Shell的反斜杠转义）。

先定义转义函数：

csv_escape() {
  local field="$1"
  # 判断字段是否需要转义
  if [[ "$field" == *'"'* || "$field" == *','* || "$field" == *$'\n'* ]]; then
    # 替换双引号为两个双引号，再包裹外层双引号
    echo "\"${field//\"/\"\"}\""
  else
    echo "$field"
  fi
}

然后在脚本中调用函数处理变量并写入：

# 写入CSV表头
echo "username,password,name" >> abc.csv
# 处理变量后写入数据行
printf "%s,%s,%s\n" \
  "$(csv_escape "$username")" \
  "$(csv_escape "$(password)")" \
  "$(csv_escape "$name")" >> abc.csv

这种方法无需修改变量源，能正确处理所有特殊字符，生成标准CSV文件。

方案2：用awk处理转义和变量替换 #

利用awk的字符串处理能力，直接传递变量并完成CSV转义：

# 写入表头
echo "username,password,name" >> abc.csv
# 通过awk传递变量并处理转义
awk -v u="$username" -v p="$(password)" -v n="$name" '
function csv_escape(s) {
  if (s ~ /[",\n]/) {
    gsub(/"/, "\"\"", s)
    return "\"" s "\""
  }
  return s
}
BEGIN { print csv_escape(u) "," csv_escape(p) "," csv_escape(n) }' >> abc.csv

awk会自动处理变量中的特殊字符，避免Shell语法解析错误，同时生成符合规范的CSV。

方案3：修正Here-Document写法 #

如果偏好Here-Document，去掉\EOF的反斜杠开启变量替换，同时提前处理变量的CSV转义：

username=my-name@abc.com
name=my-name
password=$(password)

# 处理password的CSV转义
escaped_password=$(printf "%s" "$password" | sed 's/"/""/g')
if [[ "$password" == *'"'* || "$password" == *','* ]]; then
  escaped_password="\"$escaped_password\""
fi

# 处理其他变量（按需）
escaped_username=$(csv_escape "$username")
escaped_name=$(csv_escape "$name")

# 写入CSV
cat >> abc.csv << EOF
Username,Password,Name
$escaped_username,$escaped_password,$escaped_name
EOF

注意这里需要提前调用csv_escape函数（或手动处理转义），确保变量替换时不会触发Shell错误。

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