运行.py文件时怎么向Python.exe传递命令行参数

季宁
季宁
发布时间:2026-11-20 | 12人浏览过
原创

详细讲解在终端或命令行运行.py脚本时,如何区分并正确向python.exe以及目标脚本传递命令行参数,包含参数位置规则、sys.argv与argparse解析方法及常见踩坑排查。

在命令行运行 Python 脚本时,传递参数的核心规则由参数在命令中所处的相对位置决定:紧跟在 python.exe 之后、脚本名之前的参数由 Python 解释器本身解析;而位于 .py 脚本文件名之后的参数,才会作为脚本参数被打包传递并存放在脚本内部的 sys.argv 列表中。厘清这两类参数的接收主体与摆放位置,是写出可靠自动化脚本与命令行工具的第一步。

解释器参数与脚本参数的位置分工

当我们在终端中键入一行形如 python script.py 的命令并回车时,操作系统并不是把所有内容打包塞给你的脚本代码,而是先启动 python.exe 解释器进程。命令行中的每个由空格分隔的词素都会被操作系统解析,并按照从左到右的位置交由不同的处理者消化。

运行.py文件时怎么向Python.exe传递命令行参数
图 1:命令行分界机制——以目标 .py 文件为分界线的参数分配

具体而言,一条完整的运行命令通常符合以下范式:

python [解释器选项] 脚本路径.py [脚本参数列表...]
  • 解释器选项(Python Options):紧随 python 之后。例如 -u(强制标准输出流不进行缓冲)、-B(不写入 .pyc 文件)、-v(详细追踪模块导入)。如果写在 .py 文件之后,Python 就不会把它们当作解释器开关,而是直接当作普通字符串传递给脚本。
  • 脚本参数(Script Arguments):排在 脚本路径.py 之后的全部参数。无论是以连字符开头的 --verbose,还是纯文本值 data.csv,都会原封不动地被传入该脚本环境。

在 Python 脚本中接收和读取参数的两种方式

参数传递进入脚本环境后,Python 标准库提供了不同层级的读取手段。最基础的是标准库内置变量 sys.argv,而处理复杂命令与校验时最推荐的是 argparse 模块。

1. 使用 sys.argv 获取原生参数列表

sys.argv 是一个由字符串构成的纯列表(list)。列表的第 0 项始终是当前被执行脚本的文件名称或相对路径,从第 1 项开始依次存储传入的后续参数。

创建一个名为 demo_sys.py 的文件并写入以下代码:

import sys

print(f"脚本名称: {sys.argv[0]}")
print(f"传入参数总个数: {len(sys.argv) - 1}")
print(f"完整参数列表: {sys.argv}")

if len(sys.argv) > 1:
    for index, arg in enumerate(sys.argv[1:], start=1):
        print(f"参数 {index}: {arg}")

在终端中执行命令:

python demo_sys.py alpha beta 123

终端预期输出示例:

脚本名称: demo_sys.py
传入参数总个数: 3
完整参数列表: ['demo_sys.py', 'alpha', 'beta', '123']
参数 1: alpha
参数 2: beta
参数 3: 123

需要特别注意:sys.argv 获取的所有元素类型均为字符串(str),即使输入纯数字 123,在 Python 内也是 "123",使用前须手动转换类型。

2. 使用 argparse 模块规范化管理参数

对于工业化脚本,手动根据索引取 sys.argv 极易出现索引越界(IndexError),且无法优雅支持帮助信息(--help)与默认值。Python 标准库自带的 argparse 模块可自动完成参数解析、类型转换及格式校验。

运行.py文件时怎么向Python.exe传递命令行参数
图 2:argparse 模块从注册到解析提取的标准执行步骤

编写 task_runner.py 示例:

import argparse

parser = argparse.ArgumentParser(description="演示命令行传参的脚本")
parser.add_argument("filename", help="目标处理文件(位置参数)")
parser.add_argument("-c", "--count", type=int, default=1, help="循环处理次数(可选参数,默认 1)")
parser.add_argument("--dry-run", action="store_true", help="演练模式开关")

args = parser.parse_args()

print(f"目标文件: {args.filename}")
print(f"运行次数: {args.count} (类型: {type(args.count).__name__})")
print(f"演练模式: {args.dry_run}")

执行带有可选参数与标志位的命令:

python task_runner.py report.txt --count 5 --dry-run

终端预期输出示例:

目标文件: report.txt
运行次数: 5 (类型: int)
演练模式: True

传参时必须注意的特殊场景与细节处理

在实际操作终端时,空格、特殊符号与操作系统 Shell 的解析机制常常会导致参数传递偏离预期。掌握以下几个细节可以避开大多数传参“诡异”问题。

运行.py文件时怎么向Python.exe传递命令行参数
图 3:三种典型传参边界场景的处理要点
  • 参数值包含空格:在 Windows CMD、PowerShell 或 Linux Bash 中,系统均默认以空格切分参数。若参数本身包含空格(如文件路径 C:\Program Files\data.txt),必须使用英文双引号将其整体包裹:"C:\Program Files\data.txt",否则 Python 会将其切分成两个独立的元素。
  • 传递带负号的数值:如果需要传递负数(例如 -10 作为阈值),使用 argparse 时容易报错 unrecognized arguments: -10,因为解释器默认将 - 开头的词素视作开关选项。解决方案是采用等号显式赋值(如 --offset=-10),或者在参数列表前加入独立的 -- 标记,告诉解析器其后所有参数均为纯位置参数。
  • 使用 -m 模块方式运行时的传参:当运行命令为 python -m my_package.cli run --verbose 时,-m 作为 Python 解释器的参数,将 my_package.cli 作为主入口加载,而随后的 run --verbose 依旧作为脚本参数流入该模块。

核心规则全流程总结

在命令行向 Python 传递参数的整个决策与流转流程可归纳为如下检查清单:

运行.py文件时怎么向Python.exe传递命令行参数
图 4:解释器参数与脚本参数各维度特性总结
一句话速记原则:以目标 .py 脚本名称为界,左边交给解释器,右边留给业务脚本;简易临时调试用 sys.argv,对外发布与标准化工具优先使用 argparse。
相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表