ImageCompressor

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #go #rust #deep-learning #docker #windows #cli #kubernetes #pytorch #openai

ImageCompressor

(★ 15)

一个简单易用的桌面图片压缩工具，支持拖放操作，精确控制压缩大小，基于 .NET Framework4.8 + WPF 构建。

ImageCompressor Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 图片压缩工具 🦞

一个简单易用的桌面图片压缩工具，支持拖放操作，精确控制压缩大小，基于 .NET Framework 4.8 + WPF 构建，可在 Windows 10 上运行。

## 项目结构

```
ImageCompressor/
├── ImageCompressor.slnx         # 解决方案文件
├── ImageCompressor.csproj        # 项目文件
├── README.md                     # 项目说明（本文件）
├── .gitignore                    # Git 忽略文件
├── MainWindow.xaml               # 主窗口界面
├── MainWindow.xaml.cs            # 主窗口逻辑
├── App.xaml                      # 应用程序定义
├── App.xaml.cs                   # 应用程序入口
└── Program.cs                    # 程序入口
```

## 快速开始

### 最快方式：直接运行编译好的程序

1. **下载**：从发布文件中获取 `ImageCompressor.exe`
2. **运行**：直接双击运行（无需安装）
3. **开始使用**：拖放图片，选择大小，开始压缩

### 开发方式：从源码编译

```bash
# 1. 克隆仓库
git clone <repository-url>
cd ImageCompressor

# 2. 还原依赖
dotnet restore "ImageCompressor.csproj"

# 3. 编译运行
dotnet run --project "ImageCompressor.csproj" -p:Platform=x64

# 4. 发布 Windows 10 版本
dotnet publish "ImageCompressor.csproj" -c Release -p:Platform=x64

# 5. 同时发布 32 位和 64 位版本
发布32位和64位版本.bat
```

## 功能特点

- 🎯 **精确控制**：可设置目标文件大小（如100KB、200KB等）
- 🖱️ **拖放操作**：直接拖放图片到窗口即可
- 📊 **智能压缩**：自动调整压缩质量，找到最佳平衡点
- 🎨 **简约界面**：现代化UI设计，操作直观
- ⚡ **批量处理**：支持同时压缩多张图片
- 💾 **自动保存**：压缩后的文件保存在你选择的输出目录
- 🪟 **Windows 10 兼容**：基于 .NET Framework 4.8 发布

## 项目截图

![图片压缩工具界面](https://raw.githubusercontent.com/coolcalf/ImageCompressor/main/demo.jpg)

## 技术栈

- **C# / .NET Framework 4.8**
- **WPF** (Windows Presentation Foundation)
- **System.Drawing** (图像处理)

## 如何运行

### 方式1：使用Visual Studio 2022

1. 打开 Visual Studio 2022
2. 选择"创建新项目"
3. 搜索"WPF Application"并创建
4. 将以下文件复制到项目中：
   - `MainWindow.xaml`
   - `MainWindow.xaml.cs`
   - `Program.cs`
   - `App.xaml`
   - `App.xaml.cs`
5. 在解决方案资源管理器中右键点击项目 → "管理NuGet程序包"
6. 安装 `SharpCompress` 包
7. 按 F5 运行

### 方式2：使用命令行

```bash
# 进入项目目录
cd ImageCompressor

# 还原依赖
dotnet restore "ImageCompressor.csproj"

# 运行
dotnet run --project "ImageCompressor.csproj" --framework net48 -p:Platform=x64
```

## 使用方法

1. **拖放图片**：将图片拖放到虚线框区域
2. **设置目标大小**：从下拉菜单选择预设大小（100KB、200KB、500KB、1MB），或选择"自定义"输入自定义大小
3. **调整压缩质量**：拖动滑块设置压缩质量范围（10%-80%）
4. **开始压缩**：点击"开始压缩"按钮
5. **查看结果**：压缩完成后，点击"打开文件"查看压缩后的图片

## 输出说明

- 压缩后的图片保存在：`原文件夹/压缩后/`
- 文件名格式：`原图名_compressed.扩展名`
- 压缩后文件会自动添加"_compressed"后缀

## 示例

```
原图：photo.jpg (2.5 MB)
压缩到：200 KB
结果：photo_compressed.jpg (198 KB)
```

## 编译和部署

### 环境要求

- **.NET SDK 8/9/10 任一可用版本**（用于编译 SDK-style `net48` 项目）
- **Windows 10/11**
- **目标机器需安装或启用 .NET Framework 4.8**

### 快速编译（调试模式）

```bash
# 进入项目目录
cd ImageCompressor

# 还原依赖
dotnet restore "ImageCompressor.csproj"

# 编译运行
dotnet run --project "ImageCompressor.csproj" -p:Platform=x64
```

### 发布为可执行文件（推荐）

`.NET Framework 4.8` 不是现代 `.NET` 的 self-contained 模式，因此推荐直接分发 `publish` 目录。

```bash
dotnet publish "ImageCompressor.csproj" -c Release -p:Platform=x64
dotnet publish "ImageCompressor.csproj" -c Release -p:Platform=x86
```

- ✅ 生成适合 Windows 10 的发布目录
- ✅ 直接运行生成的 `ImageCompressor.exe`
- ✅ 适合打包为 zip/rar 后分发
- 注意：请直接针对 `ImageCompressor.csproj` 执行 `dotnet publish`，避免根目录下 `.slnx` 的配置映射问题
- 注意：目标机器需要启用 `.NET Framework 4.8`
- 注意：`QuestPDF` 依赖原生库，必须按架构发布，不能使用 `Any CPU`

也可以直接双击仓库根目录下的 `发布Windows10版本.bat` 或 `发布32位和64位版本.bat`。

### 发布文件位置

编译成功后，可执行文件位于：

```text
bin/x64/Release/net48/win-x64/publish/
├── ImageCompressor.exe  <- 64-bit main program
├── QuestPDF.dll
├── qpdf.dll
└── ...

bin/x86/Release/net48/win-x86/publish/
├── ImageCompressor.exe  <- 32-bit main program
├── QuestPDF.dll
├── qpdf.dll
└── ...
```

把对应架构的整个 `publish` 目录一起拷贝到目标机器，直接运行 `ImageCompressor.exe` 即可使用。

## 使用方法

1. **拖放图片**：将图片拖放到虚线框区域
2. **设置输出目录**：点击"选择输出目录"选择保存位置，或使用默认的桌面"\压缩后"
3. **设置目标大小**：从下拉菜单选择预设大小（100KB、200KB、500KB、1MB），或选择"自定义"输入自定义大小
4. **选择压缩模式**：
   - "尽可能压缩"：以最小质量为代价，严格控制在目标大小内
   - "保持较好质量"：在质量损失可控的情况下接近目标大小
5. **开始压缩**：点击"开始压缩"按钮，按钮会被禁用直到完成
6. **查看结果**：压缩完成后查看统计信息和压缩效果

## 输出说明

- 压缩后的图片保存在：`你选择的输出目录`
- 默认输出目录：`桌面\压缩后`
- 文件名格式：`原图名_compressed.扩展名`
- 压缩后文件会自动添加"_compressed"后缀

## 示例

```
原图：photo.jpg (2.5 MB)
目标：200 KB
模式：尽可能压缩
结果：photo_compressed.jpg (198 KB)
```

## 注意事项

- 支持的格式：JPG、PNG、GIF、BMP
- 压缩后的图片质量会比原图有所降低
- 当前策略下，非 `jpg/jpeg` 图片会先转换为 `jpg`，再执行压缩；透明背景会转为白底
- 对于非常大的图片，可能需要一些时间处理
- 压缩质量范围设置为10%-80%，避免过度压缩导致图片严重失真
- `QuestPDF` 使用原生依赖，若出现 `BadImageFormatException`，优先检查是否选错了 x86/x64 版本

## 许可证

MIT License

ImageCompressor

ImageCompressor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ImageCompressor

ImageCompressor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README