当前位置：首页 > news >正文

10分钟入门filetype.py：新手必备的文件类型识别工具使用教程

news 2026/7/6 18:05:06

10分钟入门filetype.py：新手必备的文件类型识别工具使用教程

【免费下载链接】filetype.pySmall, dependency-free, fast Python package to infer binary file types checking the magic numbers signature项目地址: https://gitcode.com/gh_mirrors/fi/filetype.py

想要在Python中快速、准确地识别文件类型吗？🤔 无论您是处理用户上传的文件、进行文件分类，还是需要验证文件格式，filetype.py都是您的终极解决方案！这个轻量级的Python文件类型识别库，通过检查文件的魔法数字签名来推断文件类型，无需任何外部依赖，让文件类型识别变得简单又高效。

什么是filetype.py？🔍

filetype.py是一个小巧、无依赖、快速的Python包，专门用于推断二进制文件的类型。它通过检查文件的魔法数字签名（文件头部的特定字节序列）来识别文件格式，而不是依赖文件扩展名。这种方法更加可靠，因为文件扩展名可以被轻易修改，而魔法数字签名才是文件格式的真正"指纹"。

核心功能亮点 ✨

简单友好的API：几行代码即可完成文件类型识别
支持广泛的文件类型：涵盖图像、视频、音频、文档、压缩包等200+种格式
零依赖：纯Python实现，无需安装libmagic或其他C扩展
极速识别：仅需读取前261字节即可判断文件类型
跨平台兼容：在任何支持Python的系统上都能正常工作

快速安装指南 🚀

开始使用filetype.py非常简单，只需一条命令：

pip install filetype

就是这么简单！无需配置复杂的环境，无需安装额外的系统库。filetype.py完全基于Python实现，安装后即可立即使用。

基础使用教程 📚

1. 识别文件类型

最基本的用法是识别一个文件的类型：

import filetype # 识别文件类型 kind = filetype.guess('sample.jpg') if kind is None: print('无法识别文件类型！') else: print(f'文件扩展名: {kind.extension}') print(f'MIME类型: {kind.mime}')

2. 直接获取MIME类型或扩展名

如果您只需要MIME类型或文件扩展名，可以使用更便捷的方法：

import filetype # 获取MIME类型 mime_type = filetype.guess_mime('sample.jpg') print(f'MIME类型: {mime_type}') # 输出: image/jpeg # 获取文件扩展名 extension = filetype.guess_extension('sample.jpg') print(f'文件扩展名: {extension}') # 输出: jpg

3. 从字节数据识别

filetype.py不仅支持文件路径，还支持直接传入字节数据：

import filetype # 从字节数据识别 with open('sample.jpg', 'rb') as f: header = f.read(261) # 只需读取前261字节 kind = filetype.guess(header) if kind: print(f'识别为: {kind.extension} ({kind.mime})')

filetype.py可以准确识别JPEG图像文件

支持的丰富文件类型 📁

filetype.py支持超过200种文件格式，涵盖几乎所有常见类型：

图像文件格式 📸

JPEG/JPG-image/jpeg
PNG-image/png
GIF-image/gif
WebP-image/webp
TIFF-image/tiff
BMP-image/bmp
HEIC-image/heic
AVIF-image/avif

视频文件格式 🎬

MP4-video/mp4
MKV-video/x-matroska
WebM-video/webm
AVI-video/x-msvideo
MOV-video/quicktime
WMV-video/x-ms-wmv

音频文件格式 🎵

MP3-audio/mpeg
M4A-audio/mp4
WAV-audio/x-wav
FLAC-audio/x-flac
OGG-audio/ogg
AAC-audio/aac

文档和压缩文件 📄

PDF-application/pdf
DOC/DOCX-application/msword
XLS/XLSX-application/vnd.ms-excel
ZIP-application/zip
TAR-application/x-tar
RAR-application/x-rar-compressed
7Z-application/x-7z-compressed

即使是高分辨率的TIFF图像，filetype.py也能准确识别

高级功能探索 🚀

1. 按类别查找文件类型

filetype.py支持按文件类别进行筛选：

import filetype from filetype.types import image, video, audio # 查找所有支持的图像格式 for img_type in image.TYPES: print(f'{img_type.extension}: {img_type.mime}') # 查找所有支持的视频格式 for vid_type in video.TYPES: print(f'{vid_type.extension}: {vid_type.mime}')

2. 自定义类型匹配器

如果需要识别特殊格式的文件，您可以轻松添加自定义类型匹配器：

import filetype from filetype.types import Type class MyCustomType(Type): MIME = 'application/x-myformat' EXTENSION = 'myformat' def __init__(self): super(MyCustomType, self).__init__( mime=MyCustomType.MIME, extension=MyCustomType.EXTENSION ) def match(self, buf): # 自定义匹配逻辑 return len(buf) > 3 and buf[0:4] == b'MYFM' # 注册自定义类型 filetype.add_type(MyCustomType())

3. 批量文件处理

filetype.py非常适合批量处理文件：

import os import filetype from pathlib import Path def classify_files(directory): """分类目录中的所有文件""" results = { 'images': [], 'videos': [], 'documents': [], 'others': [] } for file_path in Path(directory).glob('*'): if file_path.is_file(): kind = filetype.guess(str(file_path)) if kind: if kind.mime.startswith('image/'): results['images'].append(file_path.name) elif kind.mime.startswith('video/'): results['videos'].append(file_path.name) elif kind.mime.startswith('application/'): results['documents'].append(file_path.name) else: results['others'].append(file_path.name) return results

实际应用场景 💼

场景1：文件上传验证

在Web应用中，验证用户上传的文件类型至关重要：

import filetype ALLOWED_TYPES = {'jpg', 'png', 'gif', 'pdf', 'docx'} def validate_uploaded_file(file_path): """验证上传的文件类型""" kind = filetype.guess(file_path) if kind is None: return False, "无法识别文件类型" if kind.extension not in ALLOWED_TYPES: return False, f"不支持的文件类型: {kind.extension}" return True, f"文件类型: {kind.mime}"

场景2：文件自动分类

自动将下载文件夹中的文件分类到相应目录：

import os import shutil import filetype def organize_downloads(download_dir): """整理下载文件夹""" categories = { 'images': ['jpg', 'png', 'gif', 'webp'], 'videos': ['mp4', 'mkv', 'avi', 'mov'], 'documents': ['pdf', 'docx', 'xlsx', 'pptx'], 'archives': ['zip', 'rar', '7z', 'tar.gz'] } for filename in os.listdir(download_dir): file_path = os.path.join(download_dir, filename) if os.path.isfile(file_path): kind = filetype.guess(file_path) if kind: for category, extensions in categories.items(): if kind.extension in extensions: target_dir = os.path.join(download_dir, category) os.makedirs(target_dir, exist_ok=True) shutil.move(file_path, os.path.join(target_dir, filename)) print(f"已移动 {filename} 到 {category}/") break

场景3：安全文件扫描

检测潜在的危险文件类型：

import filetype DANGEROUS_TYPES = {'exe', 'bat', 'sh', 'jar', 'js'} def scan_for_dangerous_files(directory): """扫描危险文件类型""" import os dangerous_files = [] for root, dirs, files in os.walk(directory): for file in files: file_path = os.path.join(root, file) kind = filetype.guess(file_path) if kind and kind.extension in DANGEROUS_TYPES: dangerous_files.append({ 'path': file_path, 'type': kind.extension, 'mime': kind.mime }) return dangerous_files

filetype.py支持最新的AVIF图像格式识别

性能优化技巧 ⚡

1. 最小化文件读取

filetype.py只需要文件的前261字节，这大大提高了处理速度：

def efficient_file_check(file_path): """高效的文件类型检查""" with open(file_path, 'rb') as f: # 只读取必要的字节 header = f.read(261) return filetype.guess(header)

2. 缓存常用类型

对于频繁检查的文件类型，可以建立缓存：

import functools import filetype @functools.lru_cache(maxsize=100) def cached_guess(file_path): """带缓存的文件类型猜测""" return filetype.guess(file_path)

3. 批量处理优化

处理大量文件时，使用批量处理模式：

from concurrent.futures import ThreadPoolExecutor import filetype def batch_process_files(file_paths, max_workers=4): """批量处理文件类型识别""" with ThreadPoolExecutor(max_workers=max_workers) as executor: results = list(executor.map(filetype.guess, file_paths)) return results