Python命令行工具从入门到发布：3个实战案例让你少踩80%的坑

def search_files(path, pattern, recursive=False, verbose=False):
"""搜索文件并匹配模式"""
path = Path(path)
if not path.exists():
print(f"错误: 路径 {path} 不存在", file=sys.stderr)
sys.exit(1)

files_found = 0
if path.is_file():
files = [path]
elif recursive:
files = path.rglob("*")
else:
files = path.glob("*")

for file in files:
if file.is_file():
try:
content = file.read_text(encoding='utf-8', errors='ignore')
if re.search(pattern, content):
if verbose:
print(f"[匹配] {file.relative_to(path)}")
else:
print(file)
files_found += 1
except Exception as e:
if verbose:
print(f"[错误] {file}: {e}", file=sys.stderr)

if files_found == 0:
print("未找到匹配的文件")
sys.exit(1)

if __name__ == "__main__":
# 解析命令行参数
args = sys.argv[1:]
if len(args) < 2:
print("用法: python search.py <路径> <模式> [--recursive] [--verbose]")
sys.exit(1)

path = args[0]
pattern = args[1]
recursive = "--recursive" in args
verbose = "--verbose" in args

我第一个踩坑的地方就是参数解析。当时写了个50行的if-else链，结果用户反馈说某个参数组合会报错，我debug了两小时才发现是参数顺序的问题。所以后来果断换成了Click库。

Click让我从参数解析的泥潭里解放出来，而且官方文档写得还算清晰（比Flask的文档强多了）。看改造后的代码：

@click.command()
@click.argument('path', type=click.Path(exists=True))
@click.argument('pattern', type=str)
@click.option('--recursive', '-r', is_flag=True, help='递归搜索子目录')
@click.option('--verbose', '-v', is_flag=True, help='显示详细信息')
@click.option('--encoding', default='utf-8', help='文件编码，默认utf-8')
@click.option('--max-size', type=int, help='最大文件大小(字节)')
def search(path, pattern, recursive, verbose, encoding, max_size):
"""
在指定路径下搜索匹配正则表达式的文件

PATH: 要搜索的文件或目录路径
PATTERN: 正则表达式模式
"""
path_obj = Path(path)
files_found = 0

# 构建文件列表
if path_obj.is_file():
files = [path_obj]
elif recursive:
files = path_obj.rglob("*")
else:
files = path_obj.glob("*")

for file in files:
if not file.is_file():
continue

# 跳过过大的文件
if max_size and file.stat().st_size > max_size:
if verbose:
click.echo(f"[跳过] {file} (大小: {file.stat().st_size} > {max_size})", err=True)
continue

try:
content = file.read_text(encoding=encoding, errors='ignore')
if re.search(pattern, content):
if verbose:
click.echo(f"[匹配] {file.relative_to(path_obj)}")
else:
click.echo(str(file))
files_found += 1
except Exception as e:
if verbose:
click.echo(f"[错误] {file}: {e}", err=True)

if files_found == 0:
click.echo("未找到匹配的文件", err=True)
raise SystemExit(1)

总结一下，你可以立刻用的三个点：