如何使用Python的argparse解析含换行符的命令行参数？

你遇到的这个问题本质是shell和Python对字符串转义的处理差异：在Python代码里，"line1\nline2"里的\n会被解释成实际的换行符，但在命令行里输入的"line1\nline2"，shell会把它当成包含两个字符（反斜杠+字母n）的字符串直接传给脚本，argparse不会自动帮你解析转义序列。

下面给你几个可行的解决方案：

方案1：让shell传递实际的换行符 #

如果你的shell支持（比如bash/zsh），可以直接让shell生成带换行的字符串传给脚本：

• 手动输入换行：用双引号包裹内容，输入到line1后直接按回车，再输入line2：

./newline2argparse.py "line1
line2"

执行后脚本会直接输出换行的内容。

• 用bash的ANSI-C引号语法：$'...'会自动解析里面的转义序列，把\n转换成实际换行：

./newline2argparse.py $'line1\nline2'

方案2：在Python脚本里手动解析转义序列 #

如果希望脚本能处理命令行传入的\n转义字符（不管shell怎么传），可以在脚本里添加转义解析逻辑。这里有两种简单的实现方式：

方法A：使用ast.literal_eval #

ast.literal_eval可以安全地解析Python字符串字面量，把转义序列转换成实际字符：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import argparse
import ast

parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter)
parser.add_argument('text', help='some text with newline')
args = parser.parse_args()

# 将输入的字符串解析成Python字面量对应的字符串
args.text = ast.literal_eval(f'"{args.text}"')
print(args.text)

执行./newline2argparse.py "line1\nline2"就会输出：

line1
line2

⚠️ 注意：ast.literal_eval只解析合法的Python字面量，不会执行恶意代码，比eval安全很多，但如果输入包含未闭合的引号等非法内容会报错。

方法B：使用codecs.decode的unicode_escape编码 #

unicode_escape可以直接把字符串里的转义序列转换成对应的Unicode字符：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import argparse
import codecs

parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter)
parser.add_argument('text', help='some text with newline')
args = parser.parse_args()

# 解析转义序列
args.text = codecs.decode(args.text, 'unicode_escape')
print(args.text)

这个方法同样能处理\n、\t等常见转义字符，用法更直接。

为什么代码里传参数能正常工作？ #

因为在Python代码中，parser.parse_args(["line1\nline2"])里的"line1\nline2"是Python的字符串字面量，Python解释器会在编译阶段就把\n转换成实际的换行符，所以argparse拿到的是已经包含换行的字符串自然能正确输出。

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