Python脚本怎么接收命令行参数：sys.argv基础用法与示例

一、sys.argv 的底层结构与切分原理

当我们在终端（Bash、PowerShell 或命令提示符）中敲下类似 python task.py data.csv 100 并按下回车键时，操作系统终端与 Python 解释器协同完成了第一道解析工序：

• 空格切分：命令行会根据空格把整串命令切分成若干独立的词元（Token）。
• 列表装载：Python 解释器启动后，会自动把这些词元按顺序打包为一个由字符串构成的标准列表（List），赋值给 sys.argv。
• 0号位的特殊性：列表的首个元素 sys.argv[0] 永远是脚本自身的名称或路径；从 sys.argv[1] 开始，才是我们在脚本名称后面追加的外部实参。

从上图可以直观看出一个关键特点：即使你在终端输入了数字 25，在 sys.argv[2] 中读取出来的依然是字符串 "25"。这是初学者在进行加减计算或逻辑比对时最容易忽略的前提。

二、sys.argv 的标准操作流程与完整代码示例

在实际编写 Python 脚本时，要规范地使用 sys.argv 接收参数，通常需要遵循四个标准化步骤。

完整脚本实现：简易求和计算器

我们编写一个名为 calc.py 的完整代码文件，该脚本要求接收两个数值并输出它们的相加结果：

import sys

def main():
    # 步骤 1: 检查参数数量是否满足要求
    # 期望包含：sys.argv[0](脚本名) + 两个参数 = 3 个元素
    if len(sys.argv) != 3:
        print(f"用法提示: python {sys.argv[0]} <数值1> <数值2>")
        sys.exit(1)

    # 步骤 2: 获取参数并完成必要的类型转换
    raw_a = sys.argv[1]
    raw_b = sys.argv[2]

    try:
        val_a = float(raw_a)
        val_b = float(raw_b)
    except ValueError:
        print("错误: 传入的参数必须是可以解析的数字！")
        sys.exit(1)

    # 步骤 3: 执行核心业务计算
    result = val_a + val_b
    print(f"计算成功: {val_a} + {val_b} = {result}")

if __name__ == "__main__":
    main()

终端执行与结果验证

打开终端并定位到该脚本所在目录，分别执行以下命令观察不同的输出：

# 正常调用（示例输出）
$ python calc.py 12.5 8
计算成功: 12.5 + 8.0 = 20.5

# 参数缺失时的调用（示例输出）
$ python calc.py 12.5
用法提示: python calc.py <数值1> <数值2>

# 参数非数值时的调用（示例输出）
$ python calc.py abc 8
错误: 传入的参数必须是可以解析的数字！

三、常见陷阱与防御性写法

sys.argv 尽管简单，但它本身没有任何类型检查或语法提示机制。在日常使用中，最常出现以下三类问题：

1. 索引越界（IndexError: list index out of range）

这是使用 sys.argv 最普遍的崩溃原因。如果不加判断地直接书写 filename = sys.argv[1]，一旦调用方只输入了 python app.py，列表总长仅为 1，访问索引 1 就会直接导致程序中断。

2. 传参包含空格必须使用引号包裹

操作系统命令行默认是以“空格”作为实参分割符的。如果你希望把一个带有空格的短语整体传给脚本，必须使用双引号或单引号进行包裹。

# 错误示例：终端将其切分为 3 个参数（"hello"、"world"、"!"）
$ python print_msg.py hello world !

# 正确示例：终端将其视作单个独立参数传入 sys.argv[1]
$ python print_msg.py "hello world !"

3. 布尔值转换误区

在 Python 中，非空字符串转为布尔值时永远返回 True。因此直接调用 bool(sys.argv[1]) 会导致严重逻辑错误：

# 即使传入 "False"，bool("False") 依然返回 True！
flag = bool(sys.argv[1])  # 错误做法

# 正确的布尔解析写法：显式比较字符串字面值
flag = sys.argv[1].lower() in ("true", "1", "yes")

四、选型边界：什么时候用 sys.argv，什么时候用 argparse？

sys.argv 属于极简的原生机制，只适合特定规模的简单任务。随着脚本复杂度的提升，及时演进到更高阶的参数解析库可以大幅节省开发与维护成本。