Img2Xlsx 图片转Excel

项目简介

Img2Xlsx 是一款命令行小工具，将图片的每个像素映射为 Excel 中一个带填充色的单元格。生成的 .xlsx 文件用 Excel / WPS 打开后，缩放至 30%~50% 即可看到由单元格拼出的"像素画"。工具直接基于标准库 zipfile 写入 OOXML 格式，仅依赖 Pillow 处理图片，无需 openpyxl 等第三方 Excel 库。

工作流程

1

使用 Pillow 读取图片，解析每个像素的 RGB 颜色

↓

2

按 --max-dim 等比缩放，控制最长边像素数

↓

3

按质量档位对颜色量化，减少颜色种类

↓

4

计算每个像素对应单元格的列宽/行高，写入 OOXML 并打包为 .xlsx

核心功能

像素级映射 — 每个像素对应一个单元格填充色，重建原图色彩
零第三方 Excel 库 — 直接生成 OOXML（.xlsx）ZIP 包，仅依赖 Pillow
四档颜色量化 — low / medium / high / lossless，在体积与保真间取舍
自动等比缩放 — 按 --max-dim 限制最长边，保持原图宽高比
正方形格子 — 自动换算列宽与行高避免变形，也支持手动覆盖
命令行友好 — 自定义输出路径、质量、格子尺寸，并打印转换统计

质量档位

low

量化步进：16

颜色数：约 512

用途：文件最小

medium

量化步进：8

颜色数：约 4096

用途：均衡

high（默认）

量化步进：4

颜色数：约 32768

用途：质量最好

lossless

量化步进：1

颜色数：原图全部

用途：保留原色

技术栈一览

Python 3 Pillow OOXML (.xlsx) zipfile（标准库）命令行 CLI