图片名称格式化工具

根据 EXIF 信息来格式化图片名字，方便管理

环境与安装

本工具使用 uv 管理依赖和运行环境。

免克隆直接运行（推荐）

如果不想克隆整个仓库，可以直接使用 uvx（即 uv tool run）来运行本工具：

• format-img:

  uvx format-img [参数]
  

• modify-exif:

  uvx --from format-img modify-exif [参数]
  

克隆本地仓库运行

如果克隆了整个仓库，需要先安装依赖并同步环境：

uv sync

用法

1. format-img

格式化当前目录下的图片文件名。

基本用法

uv run format-img [-f format] [-s suffixs] [-h]

• -f 文件名的格式，默认值为 %Y%m%d%H%M%S。支持的占位符列表见下表。
• -s 要格式化文件名的后缀名列表（以逗号分隔，不区分大小写），默认值为 jpg,png,jpeg,heic。例如 -s "jpg,png"。
• -h 获取帮助信息。

支持的格式占位符：

示例

把当前目录下的 jpg 和 png 文件的名称格式化成 2017-10-01 10:17:01 的形式：

uv run format-img -s "jpg,png" -f "%Y-%m-%d %H:%M:%S"

2. modify-exif

用于读取/修改图片的 EXIF 信息。

基本用法

# 读取属性详情
uv run modify-exif -f file -r property [-s]

# 读取拍摄时间与数字化时间（only output value if -s is set）
uv run modify-exif -f file -rt [-s]

# 写入指定属性
uv run modify-exif -f file -w property -v value

# 写入拍摄时间与数字化时间
uv run modify-exif -f file -wt -v value

# 查看帮助
uv run modify-exif -h

具体示例可以参考 scripts/update-datetime.ps1，用于批量修改目标文件夹里面 yyyyMMddHHmmss 这样命名规则图片的 EXIF 时间信息。

注意事项

跨路径调用：如果要在其他路径（即不是项目根目录）下调用本工具，建议使用 --project 参数指定项目路径，例如：

uv --project D:\Development\format-img run format-img

使用 --project 可以确保 uv 能够找到该项目的环境与依赖，同时不会改变当前的工作路径（cwd），从而正确地对你当前所在的命令行路径下的图片进行格式化操作。