Python脚本执行时怎么传递命令行参数

在终端运行 Python 脚本时，向程序传递外部参数是自动化任务与日常脚本开发中最基本的操作。传递参数的基本方式是在执行命令的脚本名后追加用空格分隔的参数值，例如 python main.py input.txt 100。在 Python 内部，接收与解析这些参数主要有两种内置方式：对于仅需按顺序读取少数几个值的极简任务，可以使用内置的 sys.argv 列表；而对于需要规范选项名、类型转换、默认值及帮助提示的工程化脚本，官方标准库推荐使用 argparse 模块。本文将详细讲解这两种方式的使用步骤、底层原理、关键区别以及常见注意事项。

一、命令行参数的传递形式与底层解析机制

当我们在操作系统终端（如 Bash、Zsh 或 PowerShell）中敲下一行执行命令时，终端解释器（Shell）会首先对整行文本进行分词切分。Shell 默认以空白字符作为分隔符，将整条命令拆解为一系列独立的字符串，然后再将这个字符串数组传递给 Python 解释器进程。

例如执行命令：python main.py data.csv --batch 64 "Hello World"。Shell 切分后，传递给 Python 程序的参数列表并不是一整段文本，而是一个包含多个元素的数组。如果某个参数本身包含空格，必须使用单引号或双引号将其包裹，通知终端将其保留为一个整体，否则该参数会被无意切分成多个独立碎片。

二、快速读取方案：使用内置模块 sys.argv

sys.argv 是 Python 自带的标准模块 sys 提供的一个字符串列表。只要导入 sys，即可直接访问当前脚本接收到的所有参数。其核心规则如下：

• sys.argv[0] 存放的是被执行的脚本名称（或路径）。
• sys.argv[1] 开始依次存放脚本后追加的各个参数。
• len(sys.argv) 记录总参数个数（包含脚本名）。

完整示例代码

# demo_sys.py
import sys

def main():
    # 打印原始参数列表
    print(f"原始参数列表: {sys.argv}")
    print(f"参数总数（含脚本名）: {len(sys.argv)}")

    # 简单校验参数数量
    if len(sys.argv) < 2:
        print("错误：请提供至少一个操作目标参数！")
        print("用法示例: python demo_sys.py <filename>")
        sys.exit(1)

    target_file = sys.argv[1]
    print(f"正在处理目标文件: {target_file}")

if __name__ == "__main__":
    main()

运行与输出演示

# 示例 1：未传递参数时执行
$ python demo_sys.py
原始参数列表: ['demo_sys.py']
参数总数（含脚本名）: 1
错误：请提供至少一个操作目标参数！
用法示例: python demo_sys.py <filename>

# 示例 2：正常传入参数
$ python demo_sys.py test.txt
原始参数列表: ['demo_sys.py', 'test.txt']
参数总数（含脚本名）: 2
正在处理目标文件: test.txt

三、工业级标准实践：使用标准库 argparse

为了规范化管理命令行参数，Python 标准库提供了功能完备的 argparse 模块。使用 argparse 只需遵循固定的四个操作步骤：

1. 创建解析器对象：调用 argparse.ArgumentParser 初始化，指定工具描述。
2. 声明参数规则：通过 add_argument() 方法逐个注册需要接收的位置参数或可选选项，配置其类型、默认值与帮助说明。
3. 触发参数解析：调用 parser.parse_args()。它会自动检查终端传入的参数是否符合规则，并在不合法时输出明确的报错信息。
4. 使用解析结果：通过属性访问方式（如 args.filename）获取转换好的参数值进行业务逻辑处理。

完整示例脚本

# demo_argparse.py
import argparse

def main():
    # 1. 创建解析器对象
    parser = argparse.ArgumentParser(
        description="用于演示命令行参数接收的标准示例程序"
    )

    # 2. 声明位置参数（必填项，不带横杠前缀）
    parser.add_argument(
        "filename",
        type=str,
        help="目标文件的路径（必填字符串）"
    )

    # 3. 声明可选参数（带横杠前缀，支持指定类型与默认值）
    parser.add_argument(
        "-l", "--lines",
        type=int,
        default=10,
        help="读取的最大行数（整数类型，默认值为 10）"
    )

    # 4. 声明布尔标志参数（开关项，不接收具体值）
    parser.add_argument(
        "-v", "--verbose",
        action="store_true",
        help="是否开启详细日志输出"
    )

    # 5. 执行参数解析
    args = parser.parse_args()

    # 6. 使用解析后的参数
    print("--- 参数解析完成 ---")
    print(f"目标文件: {args.filename}")
    print(f"读取行数: {args.lines} (类型: {type(args.lines).__name__})")
    print(f"详细模式: {args.verbose} (类型: {type(args.verbose).__name__})")

if __name__ == "__main__":
    main()

运行与测试表现

该脚本展示了 argparse 的自动化能力：

# 场景 1：查看自动生成的帮助信息
$ python demo_argparse.py --help
usage: demo_argparse.py [-h] [-l LINES] [-v] filename

用于演示命令行参数接收的标准示例程序

positional arguments:
  filename              目标文件的路径（必填字符串）

options:
  -h, --help            show this help message and exit
  -l LINES, --lines LINES
                        读取的最大行数（整数类型，默认值为 10）
  -v, --verbose         是否开启详细日志输出

# 场景 2：省略可选参数，仅传位置参数
$ python demo_argparse.py app.log
--- 参数解析完成 ---
目标文件: app.log
读取行数: 10 (类型: int)
详细模式: False (类型: bool)

# 场景 3：同时传入可选参数和标志位
$ python demo_argparse.py app.log --lines 50 -v
--- 参数解析完成 ---
目标文件: app.log
读取行数: 50 (类型: int)
详细模式: True (类型: bool)

# 场景 4：传入非法类型参数（自动拦截并提示错误）
$ python demo_argparse.py app.log --lines abc
usage: demo_argparse.py [-h] [-l LINES] [-v] filename
demo_argparse.py: error: argument -l/--lines: invalid int value: 'abc'

四、关键差异对比：位置参数与可选参数

命令行参数主要分为两大家族：位置参数（Positional Arguments）与可选参数/标志位（Optional Arguments / Flags）。理解两者的设计意图与差异，能够帮助我们在设计命令行接口时选择最合理的数据输入方式。

五、命令行参数传递时的常见陷阱与注意事项

在日常编写与执行传参脚本时，容易遇到以下三处典型问题：

1. 参数类型陷阱：永远警惕字符串隐式拼接

终端传递的一切值在未经转换前都是纯字符串。若在 sys.argv 中直接运算：

# 错误示例
val1 = sys.argv[1] # 假设传入 10
val2 = sys.argv[2] # 假设传入 20
print(val1 + val2) # 输出 "1020"，产生字符串拼接而非数值相加！

# 正确做法：必须显式强转类型，或使用 argparse 的 type=int 参数声明
val1 = int(sys.argv[1])

2. 布尔开关参数的 type=bool 陷阱

很多初学者在 argparse 中定义布尔选项时会误写成 parser.add_argument("--flag", type=bool)。在 Python 中，bool("False") 的返回值依然是 True（因为任何非空字符串强转布尔值均为真）。

• 推荐做法：如果该选项是一个开关，使用 action="store_true"（未传入时为 False，命令行输入该标识时自动为 True）。
• 如果确实需要传入显式的 true/false 字符串并转成布尔，应自定义类型转换函数。

3. 含空格或特殊字符的文件路径

当参数值中包含空格（如 Windows 上的 C:\Program Files 或包含空格的句子）时，在终端传递必须用双引号包裹：

# 错误传参：终端会将其识别为两个参数
python script.py C:\Program Files\data.csv

# 正确传参：保持为一个整体参数
python script.py "C:\Program Files\data.csv"

六、选型指南与核心要点总结

在实际项目中，面对不同的需求复杂度，建议采取以下选型依据：

总的来说，向 Python 脚本传递命令行参数只需要在终端执行时以空格追加相应的值。如果是个人临时运行的代码片段，使用 sys.argv 即可快速满足需求；而对于面向他人或在生产环境中长期部署的自动化脚本，使用 argparse 规范化管理参数则是最健壮、最专业的做法。