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

一、最基础的方式：使用 sys.argv 捕获参数

无论你是否使用了高级解析库，操作系统在启动 Python 进程时，都会将命令行中输入的内容依次切分为字符串，并存放于内置模块 sys 的 argv 列表中。

在这个列表中，sys.argv[0] 永远保留脚本自身的名称（或文件路径），而读者从终端传入的第一个实际参数对应 sys.argv[1]，第二个参数对应 sys.argv[2]，依此类推。

代码示例：基础传参脚本

新建一个名为 greet.py 的文件，编写如下逻辑：

import sys

def main():
    # 检查是否传入了足够的参数
    if len(sys.argv) < 3:
        print("用法错误: 请提供姓名和打招呼次数")
        print("示例: python greet.py 张三 3")
        sys.exit(1)

    name = sys.argv[1]
    count_str = sys.argv[2]

    # 注意：sys.argv 中的所有元素均为纯字符串，需要手动转换类型
    count = int(count_str)

    for i in range(count):
        print(f"第 {i + 1} 次问候: 你好，{name}！")

if __name__ == "__main__":
    main()

在终端中执行该命令并传入具体参数：

第 1 次问候: 你好，张三！
第 2 次问候: 你好，张三！
第 3 次问候: 你好，张三！

二、规范化进阶方案：使用标准库 argparse

当脚本参数超过两个，或者需要支持可选参数（例如 --output result.txt）、开关标志（例如 --verbose）、默认值和自动生成帮助手册时，使用 sys.argv 编写的大量判断逻辑会让代码极度脆弱。

Python 官方标准库内置了 argparse 模块，无需额外安装任何第三方依赖，是构建生产级命令行工具的标准工具。

argparse 的标准四步流程

1. 导入模块并创建解析器：实例化 argparse.ArgumentParser，并提供描述文字。
2. 声明所需参数：调用 add_argument() 方法明确参数名称、期望类型、默认值与帮助说明。
3. 解析命令行：调用 parser.parse_args() 自动读取并验证用户传参。
4. 在逻辑中使用属性：通过属性访问（如 args.filename）获取已经过类型转换的数据。

import argparse

def process_file():
    # 步骤 1: 创建解析器
    parser = argparse.ArgumentParser(description="文件数据批量清洗与处理工具")

    # 步骤 2: 声明参数
    # 位置参数（必填项）：没有前缀连字符
    parser.add_argument("filename", help="需要处理的目标数据文件路径（如 data.csv）")

    # 选项参数（选填项）：带有 -- 前缀
    parser.add_argument("--batch-size", type=int, default=32, help="每次处理的数据批次大小（默认: 32）")

    # 开关标志（布尔值）：提供该标志时为 True，不提供时为 False
    parser.add_argument("-v", "--verbose", action="store_true", help="是否输出详细执行日志")

    # 步骤 3: 执行解析
    args = parser.parse_args()

    # 步骤 4: 使用解析结果
    print(f"[*] 目标文件: {args.filename}")
    print(f"[*] 批次大小: {args.batch_size} (类型: {type(args.batch_size).__name__})")
    print(f"[*] 详细模式: {'开启' if args.verbose else '关闭'}")

if __name__ == "__main__":
    process_file()

查看自动生成的帮助文档

无需手动编写任何判断，只需输入 -h 或 --help：

usage: process.py [-h] [--batch-size BATCH_SIZE] [-v] filename

文件数据批量清洗与处理工具

positional arguments:
  filename              需要处理的目标数据文件路径（如 data.csv）

options:
  -h, --help            show this help message and exit
  --batch-size BATCH_SIZE
                        每次处理的数据批次大小（默认: 32）
  -v, --verbose         是否输出详细执行日志

实际传参运行验证

测试完整参数传递，注意观察整数类型与布尔值的生效方式：

[*] 目标文件: data.csv
[*] 批次大小: 64 (类型: int)
[*] 详细模式: 开启

三、常见认知偏差与 Shell 边界陷阱

初学者在传递参数时，往往会遇到一些看似违反直觉但实际上由 Shell 或 Python 机制决定的问题。了解这些边界条件，能够避免在脚本上线后产生隐蔽的 Bug。

偏差 1：认为在布尔参数后加 False 就能关闭选项

许多读者会尝试在 add_argument 中设置 type=bool，并以为在命令行输入 --is-admin False 就会得到 False。

原因剖析：在 Python 中，非空字符串转布尔值的结果永远是真（即 bool("False") 的结果是 True！）。因为在底层机制中，type=bool 只是简单调用内置函数 bool(str_val)。

正确解法：布尔开关应当使用 action="store_true"（默认无此项为 False，声明后为 True）或 action="store_false"。若需要支持显式传入 yes/no/true/false，应使用自定义函数或第三方解析逻辑。

偏差 2：带有空格的字符串未加引号导致参数被拆碎

在命令行环境中，Shell（无论是 Bash、Zsh 还是 Windows CMD / PowerShell）都将连续的空格作为参数分隔符。

如果文件名或字符串内容本身包含空格（如 annual report 2026.xlsx），如果不加引号保护，会被拆分成 3 个独立参数传递给 Python。

偏差 3：认为选项名称只能使用双横线

在规范的命令行设计中：

• --name：双连字符通常后接完整单词（如 --verbose、--output）。
• -v：单连字符后接单字母缩写（如 -v、-o）。
• argparse 允许为同一个参数同时绑定短参数与长参数（例如 parser.add_argument("-f", "--file")），极大提升终端录入效率。

四、方案对比与选型决策指南

在实际开发中，除了 sys.argv 和 argparse，Python 社区还有如 click 和 typer 等知名三方库。如何根据当下任务规模进行选择？以下是清晰的选型标准。

五、实战自查与排错清单

在编写完传参脚本并在终端部署前，请对照以下检查项逐一核实：

1. 检查类型转换是否放置在业务逻辑之前：如果使用 sys.argv，确保类似 port = int(sys.argv[2]) 有显式的异常捕获或在参数有效性检查后执行。
2. 检查位置参数与可选参数的命名：在 argparse 中，不带短横线的为强制必填项，带有 - 或 -- 的为可选参数。
3. 测试 --help 是否正常输出：运行 python script.py -h，观察帮助信息中每一个参数的用途描述是否通顺清晰。
4. 测试空格边界用例：若参数中可能涉及包含空格的路径（例如 Windows 下的 C:\Program Files 或 macOS 下的带空格目录），测试是否在命令行中用双引号包裹后能正常解析。