如何将Python文件排序工具的路径输入改为命令行参数？

核心问题排查与修正 #

首先，确保你正确定义了必填的directory参数，以下是标准的实现模板：

import argparse
import os
import shutil

def sort_files(directory):
    # 这里放入你原有的文件排序逻辑
    # 示例：按文件后缀分类
    category_folders = {
        '图片': ['.jpg', '.png', '.gif', '.webp'],
        '文档': ['.txt', '.docx', '.pdf', '.xlsx'],
        '视频': ['.mp4', '.avi', '.mov'],
        '压缩包': ['.zip', '.rar', '.7z']
    }

    # 创建分类目录
    for folder_name in category_folders.keys():
        target_folder = os.path.join(directory, folder_name)
        if not os.path.exists(target_folder):
            os.makedirs(target_folder)

    # 遍历文件并移动分类
    for filename in os.listdir(directory):
        file_path = os.path.join(directory, filename)
        if os.path.isfile(file_path):
            file_ext = os.path.splitext(filename)[1].lower()
            for folder, exts in category_folders.items():
                if file_ext in exts:
                    shutil.move(file_path, os.path.join(target_folder, filename))
                    break

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='对指定目录下的文件进行分类排序')
    # 定义必填位置参数directory
    parser.add_argument('directory', help='需要排序的目标目录路径')
    args = parser.parse_args()

    # 前置验证目录有效性
    if not os.path.isdir(args.directory):
        print(f"错误：目录 {args.directory} 不存在或不是有效目录")
        exit(1)

    sort_files(args.directory)
    print(f"目录 {args.directory} 文件排序完成")

常见错误原因及解决 #

• 运行时未传入参数：必须在命令行执行时指定目标路径，比如 python file_sorter.py /path/to/your/folder，直接运行程序不加参数会触发必填参数错误。
• 参数定义错误：如果误将参数设为可选（比如加了--directory前缀却没设置required=True），会导致程序无法识别必填项。上述示例用的是位置参数（无前缀），argparse默认将其视为必填项。
• 路径格式问题：路径含空格时需加引号，比如Windows下python file_sorter.py "C:\My Documents"，Linux/macOS下python file_sorter.py "/home/user/My Folder"。

验证方法 #

运行时传入正确的目录参数测试：

# Linux/macOS
python file_sorter.py ~/Downloads

# Windows
python file_sorter.py "C:\Users\YourName\Downloads"

若仍报错，检查：

1. parser.parse_args()是否被其他逻辑覆盖或未正确调用
2. 目标目录是否有读写权限，避免移动文件时出现权限报错

内容的提问来源于stack exchange，提问作者Juj