TimOliver/TOCropViewController

这是什么？

核心功能

• 01通过拖动网格覆盖层的边缘进行裁剪。
• 02支持矩形和圆形两种裁剪方式。
• 03支持按 90 度为单位旋转图片。
• 04可将裁剪框锁定为固定宽高比。
• 05裁剪结果可通过代理返回，或直接弹出分享面板。
• 06同时提供 Objective-C 类与 Swift 封装。

适用场景

• 在 iOS 应用中让用户将头像裁剪为圆形。
• 在上传或分享图片前加入裁剪步骤。
• 构建与 iOS 系统相册编辑流程一致的应用内图片编辑器。

快速上手

1. 1

   在 Podfile 中添加该 pod（Objective-C）

   pod 'TOCropViewController'
2. 2

   或在 Podfile 中添加 Swift 版本的 pod（Swift）

   pod 'CropViewController'
3. 3

   用 UIImage 创建 TOCropViewController，设置 delegate，并在应用代码中以模态方式呈现

使用前须知

• !仅面向 iOS，要求 iOS 12.0 或更高版本。
• !虽已启用 visionOS 和 Mac Catalyst 模式，但官方不予支持。

收录于专题

标签

常见问题

TOCropViewController 是什么？

面向 iOS 的图片裁剪视图控制器，支持旋转、圆形裁剪和固定比例，交互与系统相册编辑器相近。 TOCropViewController 是一个面向 iOS 的开源 UIViewController 子类，用于裁剪 UIImage 中的部分区域，并支持 90 度旋转。常见用途包括编辑头像或分享照片的局部，交互方式参照 iOS 系统相册的编辑器设计，用户上手没有门槛。

TOCropViewController 可以免费使用吗？用的什么许可证？

TOCropViewController 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

TOCropViewController 还在维护吗？

活跃维护中。TOCropViewController 最近一次提交是在 2026年11月6日。

TOCropViewController 适合用来做什么？

在 iOS 应用中让用户将头像裁剪为圆形。 在上传或分享图片前加入裁剪步骤。 构建与 iOS 系统相册编辑流程一致的应用内图片编辑器。

TOCropViewController 怎么安装和运行？

在 Podfile 中添加该 pod（Objective-C）: pod 'TOCropViewController' 或在 Podfile 中添加 Swift 版本的 pod（Swift）: pod 'CropViewController' 用 UIImage 创建 TOCropViewController，设置 delegate，并在应用代码中以模态方式呈现

在哪里获取 TOCropViewController？

源代码和安装说明在 GitHub 上：https://github.com/TimOliver/TOCropViewController