Python开发中，很多脚本需要支持外部传入参数来控制运行逻辑，同时还需要正确管理文件路径来保证脚本在不同环境下都能正常运行。sys.argv是Python标准库sys模块提供的命令行参数获取工具，不需要额外安装依赖就能使用，配合路径管理的相关方法，可以快速实现灵活的脚本功能。
sys.argv基础概念与用法
sys.argv是一个列表，用来存储运行Python脚本时传入的命令行参数，其中第一个元素固定是当前脚本的文件名，后续元素是用户传入的参数，按照传入顺序排列。
使用前需要先导入sys模块，下面是一个简单的示例，用来打印所有传入的命令行参数：
import sys
# 打印sys.argv的全部内容
print("所有参数列表:", sys.argv)
# 打印参数个数
print("参数总个数:", len(sys.argv))
如果在命令行中运行脚本时传入参数：
python test.py hello world 123
上述代码的输出结果会是：
所有参数列表: ['test.py', 'hello', 'world', '123'] 参数总个数: 4
常见参数解析场景
实际使用中，我们通常需要获取指定位置的参数，或者判断参数是否符合要求，下面是几个常见的处理场景：
- 获取单个指定参数：直接通过索引访问sys.argv的对应位置，注意索引从0开始，第一个用户参数是sys.argv[1]
- 参数数量校验：如果脚本需要固定数量的参数，可以先判断len(sys.argv)是否符合要求，不符合则提示用户
- 参数类型转换：sys.argv获取的参数都是字符串类型，需要数值类型的话要手动转换，转换时最好做异常处理
下面是一个带参数校验和类型转换的示例：
import sys
# 要求传入两个参数，第一个是文件名，第二个是重试次数
if len(sys.argv) != 3:
print("用法: python script.py <文件名> <重试次数>")
sys.exit(1)
file_name = sys.argv[1]
try:
retry_count = int(sys.argv[2])
except ValueError:
print("重试次数必须是数字")
sys.exit(1)
print(f"要处理的文件是: {file_name}, 重试次数为: {retry_count}")
路径管理结合sys.argv的实践
处理命令行参数时，经常会遇到参数是文件路径的情况，这时候需要正确管理路径，避免相对路径带来的问题。Python的os模块和pathlib模块都提供了路径处理的方法，推荐优先使用pathlib，它的语法更简洁直观。
常见问题：相对路径的基准目录
很多开发者会直接用sys.argv获取的路径作为文件操作路径，但是如果用户传入的是相对路径，这个相对路径的基准是当前运行命令的终端所在目录，而不是脚本所在目录，很容易出现文件找不到的问题。
比如脚本在/root/scripts目录下，用户在/home/user目录运行命令：
python /root/scripts/test.py ./data.txt
这时候sys.argv[1]是./data.txt，实际指向的是/home/user/data.txt，而不是/root/scripts/data.txt，如果脚本期望的是脚本所在目录下的data.txt，就会出错。
正确的路径处理方式
我们可以通过获取脚本所在目录的绝对路径，再结合传入的参数路径，拼接出正确的绝对路径，下面是两种实现方式：
使用os模块处理
import sys
import os
# 获取脚本所在目录的绝对路径
script_dir = os.path.dirname(os.path.abspath(__file__))
# 获取用户传入的文件路径参数
input_path = sys.argv[1]
# 拼接为绝对路径，如果是相对路径会基于脚本目录拼接
abs_path = os.path.join(script_dir, input_path)
print(f"传入的原始路径: {input_path}")
print(f"处理后的绝对路径: {abs_path}")
使用pathlib模块处理
import sys
from pathlib import Path
# 获取脚本所在目录的绝对路径
script_dir = Path(__file__).parent.resolve()
# 获取用户传入的文件路径参数，转换为Path对象
input_path = Path(sys.argv[1])
# 拼接为绝对路径
abs_path = script_dir / input_path
print(f"传入的原始路径: {input_path}")
print(f"处理后的绝对路径: {abs_path}")
完整示例：带路径处理的参数脚本
下面是一个完整的示例，脚本接收一个输入文件路径和一个输出目录路径，读取输入文件内容后，输出到输出目录下，自动处理路径问题：
import sys
from pathlib import Path
def main():
if len(sys.argv) != 3:
print("用法: python process_file.py <输入文件路径> <输出目录路径>")
sys.exit(1)
# 获取脚本所在目录
script_dir = Path(__file__).parent.resolve()
# 处理输入文件路径
input_arg = Path(sys.argv[1])
input_path = script_dir / input_arg if not input_arg.is_absolute() else input_arg
# 处理输出目录路径
output_arg = Path(sys.argv[2])
output_dir = script_dir / output_arg if not output_arg.is_absolute() else output_arg
# 校验输入文件是否存在
if not input_path.exists():
print(f"错误: 输入文件 {input_path} 不存在")
sys.exit(1)
# 创建输出目录（如果不存在）
output_dir.mkdir(parents=True, exist_ok=True)
# 读取输入文件内容，输出到输出目录下同名文件
output_file = output_dir / input_path.name
try:
content = input_path.read_text(encoding="utf-8")
output_file.write_text(content, encoding="utf-8")
print(f"文件处理完成，输出路径: {output_file}")
except Exception as e:
print(f"处理文件时出错: {e}")
sys.exit(1)
if __name__ == "__main__":
main()
注意事项
- sys.argv只能处理简单的参数场景，如果参数比较复杂，比如带选项、可选参数，推荐使用argparse模块，功能更完善
- 处理路径时尽量使用绝对路径，避免相对路径带来的环境依赖问题
- 对用户输入的参数一定要做校验，包括参数数量、参数格式、路径是否存在等，提升脚本的健壮性
- 如果参数中包含特殊字符，比如空格，用户在命令行传入时可能需要加引号，脚本中获取到的会是完整的字符串