Argparse显示预期参数却提示‘无法识别参数’的问题

在PyCharm运行配置中能正常识别的Python脚本参数，通过zsh脚本传递时却报错「unrecognized arguments」，错误信息中明明列出了预期的--freq和--n_periods参数，但仍提示不识别。

相关代码 #

Python参数定义与使用 #

from argparse import ArgumentParser, Namespace

class BQJob:
    def __init__(self):
        self.parser: ArgumentParser = self.create_parser(__name__)
        self.args: Namespace = self.parser.parse_args()
        self.freq = self.args.freq
        self.n_periods = self.args.n_periods

    def create_parser(self, name):
        parser = ArgumentParser(name)
        parser.add_argument("--freq", help='Frequency of report, choose from "M", "D", "W".', action="store",
                            default=None)
        parser.add_argument("--n_periods", type=int, help='How many periods to analyze', action="store", default=None)
        return parser

class SomeJob(BQJob):
    def __init__(self):
        super(SomeJob, self).__init__()

    def run(self):
        # 业务逻辑执行
        pass

# 确保脚本有执行入口
if __name__ == "__main__":
    job = SomeJob()
    job.run()

原Shell脚本（zsh） #

#!/bin/zsh

cd $HOME || exit
PROJECT_DIR="$HOME/project_folder"
PROG="$PROJECT_DIR/src/python/jobs/python_job.py"
FREQ="W"
ARGS="--freq $FREQ --n_periods 1"
export PYTHONPATH="$PROJECT_DIR"
echo "PYTHONPATH: $PYTHONPATH"
python $PROG $ARGS 2>> "$PROJECT_DIR/logs/job_err.log" >> "$PROJECT_DIR/logs/job_out.log"

错误信息 #

usage: src.python.job_query [-h][--freq FREQ]
                            [--n_periods N_PERIODS]
src.python.job_query: error: unrecognized arguments: --freq W --n_periods 1

问题原因 #

Shell中直接使用字符串变量存储参数时，$ARGS会被整体解析为一个单一的参数传递给Python，而不是拆分成--freq、W、--n_periods、1四个独立参数。Python的argparse会把这整串当成未定义的位置参数，因此报错。

解决方案 #

方案1：使用Shell数组存储参数（推荐） #

修改Shell脚本中参数的定义和传递方式，用数组来保存每个独立参数：

#!/bin/zsh

cd $HOME || exit
PROJECT_DIR="$HOME/project_folder"
PROG="$PROJECT_DIR/src/python/jobs/python_job.py"
FREQ="W"
# 用数组存储每个独立参数
ARGS=(--freq "$FREQ" --n_periods 1)
export PYTHONPATH="$PROJECT_DIR"
echo "PYTHONPATH: $PYTHONPATH"
# 用数组展开方式传递参数
python "$PROG" "${ARGS[@]}" 2>> "$PROJECT_DIR/logs/job_err.log" >> "$PROJECT_DIR/logs/job_out.log"

这种方式能正确拆分参数，即使参数值包含空格也能正常处理。

方案2：使用eval（不推荐，存在安全风险） #

如果必须使用字符串存储参数，可以通过eval强制Shell重新解析参数：

#!/bin/zsh

cd $HOME || exit
PROJECT_DIR="$HOME/project_folder"
PROG="$PROJECT_DIR/src/python/jobs/python_job.py"
FREQ="W"
ARGS="--freq $FREQ --n_periods 1"
export PYTHONPATH="$PROJECT_DIR"
echo "PYTHONPATH: $PYTHONPATH"
# 使用eval解析参数
eval python "$PROG" $ARGS 2>> "$PROJECT_DIR/logs/job_err.log" >> "$PROJECT_DIR/logs/job_out.log"

⚠️ 注意：当参数中包含特殊字符（如空格、引号、通配符）时，eval可能会执行意外的命令，存在安全隐患，因此不推荐使用。

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