# excel-image-cleaner

**Repository Path**: zseagate/excel-image-cleaner

## Basic Information

- **Project Name**: excel-image-cleaner
- **Description**: Excel Image Cleaner | Excel图片清理工具 一键批量清理Excel中的DISPIMG图片公式、嵌入图片、绘图资源，**仅删除图片相关内容，100%保留所有正常数据、公式和格式**，完全无依赖，离线可用。
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel Image Cleaner | Excel图片清理工具

```

一键批量清理Excel中的DISPIMG图片公式、嵌入图片、绘图资源，**仅删除图片相关内容，100%保留所有正常数据、公式和格式**，完全无依赖，离线可用。
 
---
 
## ✨ 功能特性
✅ 完全无第三方依赖，离线环境直接运行  
✅ 零误删：精准识别DISPIMG公式，不会删除任何正常数据/公式/格式  
✅ 支持批量处理整个目录下的所有.xlsx/.xlsm文件  
✅ 自动跳过无图片的文件，节省处理时间  
✅ 支持Windows/Linux/macOS全平台  
✅ 提供Go和Python两个版本，按需选择
 
---
 
## 📦 快速使用
### 👉 Go版本（推荐，速度快，单文件可执行）
1. 直接下载 `go-version/remove_excel_images.go`
2. 编译（无需网络）：`go build remove_excel_images.go`
3. 运行：
   ```bash
   # 处理单个文件
   remove_excel_images.exe test.xlsx
   
   # 处理整个目录
   remove_excel_images.exe ./excel_files
```

### 👉 Python版本（无需编译，直接运行）

1. 直接下载 `python-version/remove_excel_images.py`

2. 运行：

   bash

   ```
   # 默认模式（无依赖）
   python remove_excel_images.py test.xlsx
    
   # 深度模式（需安装openpyxl，额外清理图片关键词单元格）
   python remove_excel_images.py test.xlsx --deep
   ```

------

## 🧹 清理范围

| 清理内容       | 说明                                            |
| -------------- | ----------------------------------------------- |
| DISPIMG公式    | 完全清除WPS生成的`=DISPIMG("ID_XXX",1)`图片公式 |
| 嵌入图片       | 删除所有png/jpg/gif/bmp/webp等图片资源          |
| cellimages配置 | 删除DISPIMG专属配置文件                         |
| 绘图文件       | 删除所有drawing绘图相关文件                     |
| 图片引用       | 清理所有XML中的图片关联引用                     |
| #REF!错误      | 自动清理DISPIMG删除后产生的#REF!错误            |

> 🎯 所有普通文本、数字、公式、格式、样式、宏等正常内容100%保留，不会误删。

------

## 🆚 版本对比

| 对比项   | Go版本                         | Python版本                     |
| -------- | ------------------------------ | ------------------------------ |
| 依赖     | 无任何依赖                     | 默认无依赖，深度模式需openpyxl |
| 速度     | 快（2~3倍于Python）            | 中等                           |
| 部署     | 编译后为单文件exe，无需环境    | 需要Python运行环境             |
| 适用场景 | 批量处理大量文件、无Python环境 | 小批量处理、需要深度清理       |

------

## ❓ 常见问题

1. **处理后的文件打不开/空白？**
   已修复打包逻辑，优先写入核心配置文件，不会出现该问题。
2. **会修改原始文件吗？**
   不会，所有处理后的文件会生成新的`xxx_cleaned.xlsx`，原始文件不受影响。
3. **支持.xls格式吗？**
   仅支持新版Excel格式.xlsx/.xlsm，.xls格式请先转成.xlsx再处理。