如何防止用户输入未转义的命令行参数引发异常？

先看一个解析单个文本/URL参数的测试程序：

#!/usr/bin/env python

import argparse

def parse_input():
    parser = argparse.ArgumentParser(
        description='Program description'
    )
    parser.add_argument('input_text', type=str, help='A string')
    args = parser.parse_args()

    return args.input_text

if __name__ == '__main__':
    text = parse_input()
    print(f"Input text: \"{text}\"")

当用户用引号包裹包含querystring的URL时，程序能正常工作：

$ ./test.py  "sometext?somearg=someval&somearg2=someval2"
Input text: "sometext?somearg=someval&somearg2=someval2"

但如果用户忘记加引号，就会出现异常：

$ ./test.py  sometext?somearg=someval&somearg2=someval2
[1] 5174
$ Input text: "sometext?somearg=someval"
^C
[1]+  Done                   ./test.py sometext?somearg=someval

问题原因 #

这是Bash等Shell的解析规则导致的：未转义的&会被识别为后台执行符号。Shell会把./test.py sometext?somearg=someval放到后台运行，同时在前台执行somearg2=someval2（仅为当前Shell会话赋值）。如果querystring里有更多参数，Shell会把它们逐个当成独立命令执行；若参数名恰好和系统命令重名（比如&ls），还会直接执行对应命令，存在安全风险。

解决办法 #

由于Shell在启动程序前就已经处理了特殊字符，程序本身无法获取到用户原本想输入的完整内容，因此需要从引导正确输入和提供替代输入方式入手：

1. 增强帮助提示，明确告知特殊字符处理规则

修改argparse的描述信息，直接提醒用户注意特殊字符的处理：

parser = argparse.ArgumentParser(
    description='处理文本/URL输入。注意：包含&、?等Shell特殊字符的内容，请用引号包裹或转义（如\&）'
)
parser.add_argument('input_text', type=str, help='要处理的字符串/URL，含特殊字符时需用引号包裹')

2. 支持从标准输入读取内容

增加从stdin读取输入的逻辑，让用户可以绕过Shell的特殊字符解析，直接传入完整内容：

#!/usr/bin/env python

import argparse
import sys

def parse_input():
    parser = argparse.ArgumentParser(
        description='处理文本/URL输入，含特殊字符时推荐通过标准输入传入'
    )
    # 将input_text设为可选参数，不传则从stdin读取
    parser.add_argument('input_text', type=str, nargs='?', 
                        help='要处理的字符串/URL（可选，若不传则从标准输入读取）')
    args = parser.parse_args()

    if args.input_text is None:
        # 读取标准输入，去除首尾空白和换行
        return sys.stdin.read().strip()
    return args.input_text

if __name__ == '__main__':
    text = parse_input()
    print(f"Input text: \"{text}\"")

使用方式示例：

# 直接粘贴输入
$ ./test.py
sometext?somearg=someval&somearg2=someval2
# 按Ctrl+D结束输入，输出完整内容

# 从文件读取
$ ./test.py < url.txt

# 通过管道传入
$ echo "sometext?somearg=someval&somearg2=someval2" | ./test.py

3. 辅助检测不完整输入（可选）

可以针对URL的格式做简单检查，比如判断输入是否以?结尾、参数是否未闭合等，给出警告提示：

if __name__ == '__main__':
    text = parse_input()
    # 简单检测：如果包含?但最后是&或=，可能是输入被Shell拆分了
    if '?' in text and (text.endswith('&') or text.endswith('=')):
        print("警告：输入的URL可能不完整，请检查是否忘记用引号包裹特殊字符！")
    print(f"Input text: \"{text}\"")

这种方法无法100%准确，但能给用户额外的提示。

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