运行Python程序时怎么传递命令行参数

在终端运行 Python 脚本时，向程序传入动态参数最直接的方式是在脚本名称后附带空格分隔的参数值，例如 python script.py arg1 arg2。Python 提供了两套主要工具来承接这些输入：基础场景使用内置的 sys.argv 列表直接读取原始字符串；而在需要定义命名开关、参数类型转换及生成自动帮助信息时，使用标准库 argparse 则是最为标准和健壮的工程方案。

图 1：命令行输入到 Python 内部对象的流转机制

方法一：使用 sys.argv 读取简单位置参数

sys 模块是 Python 内置的核心模块。其中的 sys.argv 是一个存储命令行参数的 Python 列表（List）。当你在终端执行脚本时，Python 会自动将所有以空格分隔的命令项按序填入该列表中。

sys.argv 的索引规则

理解 sys.argv 的关键在于其索引分配规则：

• sys.argv[0]：固定为当前被执行的 Python 脚本自身路径或文件名。
• sys.argv[1]：用户传入的第一个实际参数。
• sys.argv[2]：用户传入的第二个实际参数，依此类推。
• len(sys.argv)：列表的总长度，即脚本名加上所有输入参数的数量。

代码示例与执行验证

创建一个名为 greet.py 的文件，写入以下内容：

# greet.py
import sys

def main():
    # 检查参数数量，防止索引越界异常
    if len(sys.argv) < 3:
        print("错误：缺少必要参数。")
        print("用法：python greet.py <姓名> <年龄>")
        sys.exit(1)

    name = sys.argv[1]
    # sys.argv 传入的值始终是字符串，数字运算必须强制转换
    age = int(sys.argv[2])

    next_year_age = age + 1
    print(f"你好，{name}！你今年 {age} 岁，明年你将满 {next_year_age} 岁。")

if __name__ == "__main__":
    main()

在终端中定位至该文件所在目录，执行带有两个参数的命令：

python greet.py 小明 25

终端示例输出：

你好，小明！你今年 25 岁，明年你将满 26 岁。

方法二：使用 argparse 构建规范的命令行接口

对于工业级工具或需要复杂参数的程序，手动切分 sys.argv 容易引发大量重复的校验逻辑。Python 标准库内置的 argparse 模块是专为此设计的解决方案。它支持位置参数、前缀选项参数（如 -p 或 --port）、默认值设定、类型自动转换以及自动生成 --help 帮助手册。

图 2：argparse 模块的标准操作实施步骤

argparse 完整实战代码

创建一个名为 server.py 的文件，结合位置参数与可选参数：

# server.py
import argparse

def main():
    # 1. 创建解析器对象
    parser = argparse.ArgumentParser(
        description="用于启动服务并加载指定配置文件的轻量级工具"
    )

    # 2. 添加位置参数（必需项，不需要中划线前缀）
    parser.add_argument("config_file", help="配置文件的绝对或相对路径")

    # 3. 添加可选命名参数（带 -- 前缀，含类型校验与默认值）
    parser.add_argument(
        "--host",
        type=str,
        default="127.0.0.1",
        help="服务监听地址（默认：127.0.0.1）"
    )
    parser.add_argument(
        "--port",
        type=int,
        default=8000,
        help="服务监听端口号（默认：8000）"
    )

    # 4. 添加布尔开关参数（存在则为 True，不存在为 False）
    parser.add_argument(
        "--debug",
        action="store_true",
        help="开启调试输出模式"
    )

    # 5. 解析传入的命令行参数
    args = parser.parse_args()

    # 6. 直接使用解析后的属性
    print(f"配置文件路径 : {args.config_file}")
    print(f"监听地址与端口: {args.host}:{args.port} (端口类型: {type(args.port).__name__})")
    print(f"调试模式状态 : {'已开启' if args.debug else '已关闭'}")

if __name__ == "__main__":
    main()

验证常见运行姿势

场景一：仅传入必需的位置参数

python server.py app.json

输出示例：

配置文件路径 : app.json
监听地址与端口: 127.0.0.1:8000 (端口类型: int)
调试模式状态 : 已关闭

场景二：自定义可选参数并开启布尔开关

python server.py app.json --host 0.0.0.0 --port 9090 --debug

输出示例：

配置文件路径 : app.json
监听地址与端口: 0.0.0.0:9090 (端口类型: int)
调试模式状态 : 已开启

场景三：查看自动生成的帮助文档

当执行 python server.py -h 或 python server.py --help 时，argparse 会自动格式化输出如下手册：

usage: server.py [-h] [--host HOST] [--port PORT] [--debug] config_file

用于启动服务并加载指定配置文件的轻量级工具

positional arguments:
  config_file  配置文件的绝对或相对路径

options:
  -h, --help   show this help message and exit
  --host HOST  服务监听地址（默认：127.0.0.1）
  --port PORT  服务监听端口号（默认：8000）
  --debug      开启调试输出模式

方案对比与选型维度

面对不同的开发任务，选择 sys.argv 还是 argparse 取决于参数的复杂程度与代码维护要求。

图 3：两种传参实现方案的特性与边界对比

参数传递中的高频踩坑点与解决办法

1. 参数包含空格或特殊符号

Shell 解析命令时严格按空格划分参数。例如，如果要将文件路径 my report 2026.csv 作为单一参数传递给 Python 程序：

• 错误写法：python main.py my report 2026.csv —— 会被 Shell 拆分成三个独立参数：my、report 和 2026.csv。
• 正确写法：python main.py "my report 2026.csv" —— 使用英文双引号将整个带空格的字符串包裹起来，Shell 会将其保留为一个完整的参数项。

2. 数值计算必须显式转换类型

无论传入的是整数还是浮点数，Python 初始接收时均为 str。如果不经转换直接相加：

# 错误示例
a = sys.argv[1]  # 传入 "10"
b = sys.argv[2]  # 传入 "20"
result = a + b   # 结果为 "1020" 而不是 30

在 sys.argv 中必须调用 int() 或 float()，而在 argparse 中则应通过 type=int 参数让系统自动完成这一转换。

3. 避免布尔参数的类型误判

使用 argparse 时，初学者常犯的错误是定义 add_argument('--flag', type=bool)。在 Python 中，非空字符串 bool("False") 的布尔值依然是 True！

正确的布尔开关定义方式是使用 action="store_true" 或 action="store_false"，命令行中仅需输入 --flag 本身，而不需要跟值。

总结与决策建议

图 4：Python 命令行参数方案全景决策与实践总结

综上所述，运行 Python 程序时传递命令行参数是一项基础且关键的技能。日常简单实验中，sys.argv 提供了最快的接入路径；而在编写交付给他人或自动化环境运行的脚本时，借助 argparse 规范化定义参数与提示，能显著提升脚本的健壮性与可用性。