argparse 模块处理命令行参数的经典写法

逐行为你详细讲解这段代码的含义和作用。这段代码是 Python 中使用argparse模块处理命令行参数的经典写法。

---

parser = argparse.ArgumentParser(description="物流路线提取与规划工具") parser.add_argument("-f", "--file", type=str, required=True, help="要处理的文件路径 (图片或PDF)") args = parser.parse_args() file_path = args.file

第 1 行：

parser = argparse.ArgumentParser(description="物流路线提取与规划工具")

讲解：
这行代码创建了一个参数解析器对象（ArgumentParser）。

• argparse是 Python 内置的标准库，专门用来处理用户从命令行输入的参数。
• description="物流路线提取与规划工具"是对这个程序功能的简要说明。当你在终端运行程序并加上-h或--help参数时，就会显示这段描述。

✅类比理解：
就像你使用手机 App 时，App 有个名字和简介；这里ArgumentParser就是给你的 Python 脚本起个“名字”并写个“简介”。

---

第 2 行：

parser.add_argument("-f", "--file", type=str, required=True, help="要处理的文件路径 (图片或PDF)")

讲解：
这行代码向解析器添加一个命令行参数，具体含义如下：

参数	含义
"-f"	短选项（short option），用户可以在命令行用-f 文件名来传参
"--file"	长选项（long option），更清晰，如--file 文件名
type=str	指定该参数的类型是字符串（其实默认就是 str，可省略，但写上更明确）
required=True	表示这个参数是必须提供的，如果用户没给，程序会报错并提示
help="..."	当用户运行python xxx.py -h时，会显示这条帮助信息

✅举例：
用户在终端这样运行程序：

python route_tool.py -f invoice.pdf

或者

python route_tool.py --file /home/user/map.jpg

程序就能拿到invoice.pdf或/home/user/map.jpg这个值。

---

第 3 行：

args = parser.parse_args()

讲解：
这行代码真正开始解析命令行输入的内容。

• 它会读取用户实际输入的参数（比如-f xxx），并把结果存到一个命名元组（Namespace 对象）中。
• 之后你可以通过args.file来获取用户传入的文件路径。

✅打个比方：
就像老师收作业，parse_args()就是“点名收作业”的动作——看看谁交了、交的是什么。

---

第 4 行：

file_path = args.file

讲解：
这行代码从解析结果中取出用户传入的文件路径，并赋值给变量file_path，方便后续代码使用。

• 因为我们之前定义了参数叫--file，所以这里用args.file（注意：自动把--file转成了属性名file）。
• 从此以后，程序里只要用file_path，就知道是要处理哪个文件了。

✅小贴士：
如果你定义的是--input-file，那就要写成args.input_file（横杠-会自动转为下划线_）。

---

✅ 总结（给学生的小结）：

这四行代码的作用是：

让你的 Python 程序能从命令行接收一个文件路径作为输入，并且强制用户必须提供这个参数。

这是编写实用型脚本（比如自动化工具、数据处理程序）的基础技能。没有它，每次都要改代码才能换文件；有了它，只需改命令就行，非常灵活！