Python实现对文件类型的获取方法

需求引入

在工作中时常需要对文件进行各种处理，如上传下载，压缩解压等，需要获取文件的类型。 我花了一点时间研究了一下各种方案后，在本文中把探索结果记录了下来。

备选方案

• 直接根据后缀名获取
• 使用mimetypes库
• 使用magic库
• 使用file命令（仅限Unix系统）

详细使用说明

方法 1：使用mimetypes模块

Python 的 mimetypes 模块可以根据文件名猜测 MIME 类型，这是一种更可靠的方法来确定文件类型。

示例代码

import mimetypes

def get_file_type(filename: str) -> str:
    """
    使用mimetypes模块获取文件类型。
    """
    mime_type, _ = mimetypes.guess_type(filename)
    return mime_type

# 示例用法
filename = 'example.txt'  # 原始文件名

# 获取文件类型
file_type = get_file_type(filename)

print(f"File type: {file_type}")

方法 2：使用magic库

magic 是一个第三方库，它可以检测文件的内容来确定其类型，而不仅仅是依赖于文件扩展名。这通常是确定文件类型最准确的方法之一。

示例代码

首先需要安装magic库：

pip install python-magic

然后使用如下代码：

import magic

def get_file_type(filename: str) -> str:
    """
    使用magic库获取文件类型。
    """
    mime = magic.Magic(mime=True)
    return mime.from_file(filename)

# 示例用法
filename = 'example.txt'  # 原始文件名

# 获取文件类型
file_type = get_file_type(filename)

print(f"File type: {file_type}")

方法 3：使用file命令（仅限Unix系统）

如果你在Unix系统上工作，可以直接使用file命令来获取文件类型。这通常是最准确的方法之一，但只能在Unix系统上使用。

示例代码

import subprocess

def get_file_type(filename: str) -> str:
    """
    使用file命令获取文件类型。
    """
    result = subprocess.run(['file', '--mime-type', filename], capture_output=True, text=True)
    return result.stdout.strip().split(':')[1].strip()

# 示例用法
filename = 'example.txt'  # 原始文件名

# 获取文件类型
file_type = get_file_type(filename)

print(f"File type: {file_type}")

方案 直接使用文件后缀名

该方案日常也够用，但是对无后缀名，或者名称与实际类型不符的文件无效。

file_type = os.path.splitext(filename)[1]

总结

• 使用mimetypes模块是一种简单且相对可靠的方法，适用于大多数情况。
• 使用magic库可以更准确地检测文件类型，特别是当文件扩展名不可靠或不存在时。
• 使用file命令是最准确的方法之一，但仅适用于Unix系统。
• 直接使用文件后缀名，不推荐

根据具体需求选择合适的方法。如果你需要跨平台的支持并且希望尽可能准确地确定文件类型，推荐使用magic库。

踩坑记录

1. magic库安装后导入magic运行报错ImportError: failed to find libmagic. Check your installation

遇到ImportError: failed to find libmagic. Check your installation这个错误通常是由于python-magic库找不到libmagic库导致的。这可能是由于libmagic没有正确安装，或者安装路径不在系统搜索路径中。

解决措施：

确保libmagic已安装：

在大多数Linux发行版中，你可以使用包管理器来安装libmagic。例如，在Debian/Ubuntu系统中，你可以使用以下命令：

sudo apt-get install libmagic1

在macOS中，你可以使用Homebrew来安装：

brew install libmagic

安装python-magic-bin：

如果你已经安装了libmagic但仍然遇到问题，可以尝试安装python-magic-bin，这是一个包含了libmagic的预编译版本的包。你可以使用以下命令安装：

pip uninstall python-magic
pip install python-magic-bin==0.4.14

检查环境变量：

确保libmagic的库文件路径包含在LD_LIBRARY_PATH（Linux/macOS）或PATH（Windows）环境变量中。

手动设置路径：

如果以上步骤仍然不能解决问题，你可以尝试手动设置libmagic的路径。在Python脚本中，你可以这样做：

import os
os.environ['MAGIC_FILE'] = '/path/to/magic.mgc'
import magic

检查Python版本：

确认你使用的Python版本与python-magic或python-magic-bin兼容。

重新安装python-magic：

如果你已经安装了python-magic-bin，并且仍然出现问题，可以尝试彻底卸载并重新安装python-magic：

pip uninstall python-magic-bin
pip install python-magic

检查依赖项：

确认所有依赖项都已经正确安装。有时，可能还需要安装libmagic-devel或类似的开发库，这取决于你的操作系统。

使用虚拟环境：

如果你在全局环境中遇到问题，可以尝试在一个新的虚拟环境中安装和测试python-magic。

以上就是Python实现对文件类型的获取方法的详细内容，更多关于Python获取文件类型的资料请关注插件窝其它相关文章！