Struct ExifTool 

pub struct ExifTool { /* private fields */ }

ExifTool 主结构体

使用 -stay_open 模式保持 ExifTool 进程运行， 避免每次操作都重新启动进程的开销。

线程安全

ExifTool 是线程安全的，可以在多个线程间共享。 内部使用 Arc<Mutex> 保护进程通信。

Implementations

impl ExifTool

pub fn new() -> Result<Self>

创建新的 ExifTool 实例

启动一个 -stay_open 模式的 ExifTool 进程。

错误

如果 ExifTool 未安装或无法启动，返回 Error::ExifToolNotFound。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

pub fn builder() -> ExifToolBuilder

创建 ExifTool 构建器

使用 Builder 模式可以更灵活地配置 ExifTool 实例。

示例

use exiftool_rs_wrapper::ExifTool;

// 使用自定义路径
let exiftool = ExifTool::builder()
    .executable("/usr/local/bin/exiftool")
    .build()?;

pub fn with_config<P: AsRef<Path>>(&self, path: P) -> Self

基于当前实例附加配置文件参数（-config）

pub fn query<P: AsRef<Path>>(&self, path: P) -> QueryBuilder<'_>

查询单个文件的元数据

返回一个 QueryBuilder，可以使用 Builder 模式配置查询选项。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 基本查询
let metadata = exiftool.query("photo.jpg").execute()?;

// 高级查询
let metadata = exiftool.query("photo.jpg")
    .include_unknown(true)
    .tag("Make")
    .tag("Model")
    .execute()?;

pub fn query_batch<P: AsRef<Path>>(&self, paths: &[P]) -> BatchQueryBuilder<'_>

批量查询多个文件的元数据

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

let paths = vec!["photo1.jpg", "photo2.jpg", "photo3.jpg"];
let results = exiftool.query_batch(&paths)
    .tag("FileName")
    .tag("ImageSize")
    .execute()?;

for (path, metadata) in results {
    println!("{}: {:?}", path.display(), metadata.get("FileName"));
}

pub fn write<P: AsRef<Path>>(&self, path: P) -> WriteBuilder<'_>

写入元数据到文件

返回一个 WriteBuilder，可以使用 Builder 模式配置写入选项。

警告

默认情况下，ExifTool 会创建备份文件（filename_original）。 使用 overwrite_original(true) 可以不创建备份直接覆盖原文件。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 基本写入
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026 My Company")
    .execute()?;

// 高级写入
exiftool.write("photo.jpg")
    .tag("Artist", "Photographer")
    .tag("Copyright", "© 2026")
    .delete("Comment")
    .overwrite_original(true)
    .execute()?;

pub fn read_tag<T, P, S>(&self, path: P, tag: S) -> Result<T>

where T: for<'de> Deserialize<'de>, P: AsRef<Path>, S: AsRef<str>,

读取单个标签的值

这是 query().tag().execute() 的快捷方式。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

let make: String = exiftool.read_tag("photo.jpg", "Make")?;
println!("相机制造商: {}", make);

// 使用 TagId
use exiftool_rs_wrapper::TagId;
let model: String = exiftool.read_tag("photo.jpg", "Model")?;

pub fn version(&self) -> Result<String>

获取 ExifTool 版本

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;
let version = exiftool.version()?;
println!("ExifTool version: {}", version);

pub fn list_tags(&self) -> Result<Vec<String>>

获取所有支持的标签列表

pub fn list_writable_tags(&self) -> Result<Vec<String>>

获取可写标签列表（对应 -listw）

pub fn list_file_extensions(&self) -> Result<Vec<String>>

获取支持的文件扩展名列表（对应 -listf）

pub fn list_groups(&self) -> Result<Vec<String>>

获取支持的分组列表（对应 -listg）

pub fn list_groups_family(&self, family: u8) -> Result<Vec<String>>

获取指定族的分组列表（对应 -listg[NUM]）

ExifTool 将标签分组为不同的族（family），使用 -listg[NUM] 可以列出特定族的分组。

参数

• family - 分组族编号（0-7），对应 -listg0 到 -listg7
  • Family 0: 信息类型（EXIF、IPTC、XMP 等）
  • Family 1: 特定位置（MakerNotes、Composite 等）
  • Family 2: 类别（Image、Camera、Author 等）
  • Family 3-7: 其他分类方式

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 获取 Family 1 的分组列表（特定位置）
let family1_groups = exiftool.list_groups_family(1)?;
println!("Family 1 分组: {:?}", family1_groups);

// 获取 Family 2 的分组列表（类别）
let family2_groups = exiftool.list_groups_family(2)?;
println!("Family 2 分组: {:?}", family2_groups);

pub fn list_descriptions(&self) -> Result<Vec<String>>

获取标签描述列表（对应 -listd）

pub fn list_writable_file_extensions(&self) -> Result<Vec<String>>

获取可写文件类型扩展名列表（对应 -listwf）

返回 ExifTool 支持写入的文件类型扩展名列表。 与 list_file_extensions() 不同，此方法仅返回可写入元数据的文件类型。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

let writable_exts = exiftool.list_writable_file_extensions()?;
println!("可写文件类型数量: {}", writable_exts.len());

pub fn list_readable_file_extensions(&self) -> Result<Vec<String>>

获取可读文件类型扩展名列表（对应 -listr）

返回 ExifTool 支持读取的文件类型扩展名列表。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

let readable_exts = exiftool.list_readable_file_extensions()?;
println!("可读文件类型数量: {}", readable_exts.len());

pub fn list_geo_formats(&self) -> Result<Vec<String>>

获取支持的 GPS 日志格式列表（对应 -listgeo）

返回 ExifTool 支持的地理标记日志文件格式列表。

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

let geo_formats = exiftool.list_geo_formats()?;
println!("支持的 GPS 日志格式: {:?}", geo_formats);

pub fn capability_snapshot(&self) -> Result<CapabilitySnapshot>

生成当前 ExifTool 的能力快照

pub fn execute<S: AsRef<str>>(&self, args: &[S]) -> Result<Response>

执行原始命令

这是高级 API，允许直接发送参数到 ExifTool。

安全性

谨慎使用此功能，确保参数不包含恶意输入。

pub fn execute_multiple<S: AsRef<str>>( &self, commands: &[Vec<S>], ) -> Result<Vec<Response>>

批量执行多个命令（原子多命令）

使用 -executeNUM 格式在一个事务中发送多个命令， 通过编号区分各个命令的响应。

优势

• 减少进程间通信开销（一次性发送所有命令）
• 原子性：所有命令在一个批次中执行
• 支持复杂的读写链操作

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 批量执行多个命令
let commands = vec![
    vec!["-ver".to_string()],
    vec!["-list".to_string()],
];
let responses = exiftool.execute_multiple(&commands)?;

for (idx, response) in responses.iter().enumerate() {
    println!("命令 {}: {}", idx, response.text().trim());
}

pub fn close(&self) -> Result<()>

关闭 ExifTool 进程

优雅地关闭进程。通常不需要手动调用， 因为 Drop 实现会自动处理。

pub fn delete_original<P: AsRef<Path>>( &self, path: P, force: bool, ) -> Result<()>

删除备份文件

使用 -delete_original 选项删除 _original 备份文件。

参数

• path - 原始文件路径（ExifTool 会找到对应的备份文件）
• force - 是否强制删除（使用 -delete_original!）

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 删除 photo.jpg 的备份文件 photo.jpg_original
exiftool.delete_original("photo.jpg", false)?;

// 强制删除备份文件
exiftool.delete_original("photo.jpg", true)?;

pub fn restore_original<P: AsRef<Path>>(&self, path: P) -> Result<()>

从备份恢复原始文件

使用 -restore_original 选项从 _original 备份文件恢复原始文件。

参数

• path - 文件路径

示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从 photo.jpg_original 恢复 photo.jpg
exiftool.restore_original("photo.jpg")?;

Trait Implementations

impl AdvancedWriteOperations for ExifTool

fn shift_datetime<P: AsRef<Path>>( &self, path: P, offset: DateTimeOffset, ) -> Result<()>

偏移日期时间标签

fn shift_specific_datetime<P: AsRef<Path>>( &self, path: P, tag: TagId, offset: DateTimeOffset, ) -> Result<()>

仅偏移特定日期时间标签

fn numeric_operation<P: AsRef<Path>>( &self, path: P, tag: TagId, operation: NumericOperation, ) -> Result<()>

数值运算

fn append_string<P: AsRef<Path>>( &self, path: P, tag: TagId, suffix: &str, ) -> Result<()>

字符串追加

fn write_if<P: AsRef<Path>, F>( &self, path: P, condition: &str, builder_fn: F, ) -> Result<()>

where F: FnOnce(WriteBuilder<'_>) -> WriteBuilder<'_>,

条件写入

impl BinaryOperations for ExifTool

fn read_binary<P: AsRef<Path>>( &self, path: P, tag: BinaryTag, ) -> Result<Vec<u8>>

读取二进制数据

fn write_binary<P: AsRef<Path>>(&self, path: P) -> BinaryWriteBuilder<'_>

写入二进制数据

fn extract_thumbnail<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, dest: Q, ) -> Result<()>

提取缩略图到文件

fn extract_preview<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, dest: Q, ) -> Result<()>

提取预览图到文件

impl Clone for ExifTool

fn clone(&self) -> ExifTool

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConfigOperations for ExifTool

fn with_config<P: AsRef<Path>>(&self, config_path: P) -> ExifTool

加载配置文件（-config）

fn diff<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, target: Q, ) -> Result<DiffResult>

比较两个文件的元数据

fn diff_tags<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, target: Q, tags: &[TagId], ) -> Result<DiffResult>

比较两个文件的元数据（仅特定标签）

impl Debug for ExifTool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FileOperations for ExifTool

fn rename_file<P: AsRef<Path>>( &self, path: P, pattern: &RenamePattern, ) -> Result<PathBuf>

重命名单个文件

fn rename_files<P: AsRef<Path>>( &self, paths: &[P], pattern: &RenamePattern, ) -> Result<Vec<PathBuf>>

批量重命名文件

fn organize_by_date<P: AsRef<Path>, Q: AsRef<Path>>( &self, path: P, target_dir: Q, date_format: &str, ) -> Result<PathBuf>

按日期组织文件到目录

fn organize<P: AsRef<Path>>( &self, path: P, options: &OrganizeOptions, ) -> Result<PathBuf>

根据元数据组织文件

fn create_metadata_backup<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, backup_path: Q, ) -> Result<()>

生成元数据备份文件 (.mie 格式)

fn restore_from_backup<P: AsRef<Path>, Q: AsRef<Path>>( &self, backup: P, target: Q, ) -> Result<()>

从备份恢复元数据

impl FormatOperations for ExifTool

fn read_formatted<P: AsRef<Path>>( &self, path: P, options: &ReadOptions, ) -> Result<FormattedOutput>

使用自定义格式读取元数据

fn read_xml<P: AsRef<Path>>(&self, path: P) -> Result<String>

读取为 XML

fn read_csv<P: AsRef<Path>>(&self, path: P) -> Result<String>

读取为 CSV

fn read_html<P: AsRef<Path>>(&self, path: P) -> Result<String>

读取为 HTML 表格

fn read_text<P: AsRef<Path>>(&self, path: P) -> Result<String>

读取为纯文本

fn read_directory<P: AsRef<Path>>( &self, path: P, options: &ReadOptions, ) -> Result<Vec<FormattedOutput>>

递归读取目录

impl GeoOperations for ExifTool

fn get_gps<P: AsRef<Path>>(&self, path: P) -> Result<Option<GpsCoordinate>>

获取文件的 GPS 坐标

fn set_gps<P: AsRef<Path>>(&self, path: P, coord: &GpsCoordinate) -> Result<()>

设置文件的 GPS 坐标

fn remove_gps<P: AsRef<Path>>(&self, path: P) -> Result<()>

删除 GPS 信息

fn geotag_from_track<P: AsRef<Path>, Q: AsRef<Path>>( &self, image: P, track_file: Q, ) -> Result<()>

从 GPS 轨迹文件地理标记

impl HexDumpOperations for ExifTool

fn hex_dump<P: AsRef<Path>>( &self, path: P, options: &HexDumpOptions, ) -> Result<String>

获取文件的十六进制转储

fn hex_dump_tag<P: AsRef<Path>>(&self, path: P, tag: TagId) -> Result<String>

获取特定标签的十六进制值

impl StreamingOperations for ExifTool

fn process_streaming<P, F, R>( &self, path: P, options: &StreamOptions, processor: F, ) -> Result<R>

where P: AsRef<Path>, F: FnMut(&mut dyn Read) -> Result<R>,

流式处理大文件

fn process_batch_with_progress<P, F>( &self, paths: &[P], options: &StreamOptions, processor: F, ) -> Vec<Result<()>>

where P: AsRef<Path>, F: FnMut(&ExifTool, &Path, &ProgressTracker) -> Result<()>,

批量处理带进度回调

impl VerboseOperations for ExifTool

fn verbose_dump<P: AsRef<Path>>( &self, path: P, options: &VerboseOptions, ) -> Result<String>

获取详细输出