IOPaint 图片擦除工具一键更新指南：三步升到 1.6.0-平芜编程栈

IOPaint 图片擦除工具一键更新指南：三步升到 1.6.0

【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint

你打开 IOPaint 想擦掉照片里的路人，却发现模型列表停在半年前。新版本才支持的重绘模型，你这里根本选不到。这篇文章带你把 IOPaint 这个 AI 图片擦除与重绘工具升级到 1.6.0，全程约 3 分钟。

一键更新 IOPaint 的完整步骤

提示：更新前先把 IOPaint 主程序和浏览器页面都关掉，避免文件占用导致升级失败。

关闭正在运行的 IOPaint：网页标签页、命令行窗口都停掉
进入安装目录，双击scripts/user_scripts/win_update.bat：这是项目自带的 Windows 更新脚本，已封装好全部动作
等待命令行自动执行：脚本实际只做了两件事——激活环境、升级包

installer\Scripts\activate.bat pip3 install -U iopaint

看到"按任意键继续"后关闭窗口：升级完成，用win_start_cn.bat重新拉起即可

更新脚本内置了国内镜像源配置，下载速度通常不需要额外干预。

如果双击脚本没反应，或者你本来就是用pip装的 IOPaint，可以打开 cmd 手动执行：cd 安装目录; installer\Scripts\activate.bat; pip install -U iopaint，效果完全一样。

验证 IOPaint 更新是否生效的 3 个场景

场景 1：版本号对得上

在命令行执行pip show iopaint，看Version一行是否显示1.6.0。不是的话，说明刚才的升级命令没跑完，重跑一次即可。

场景 2：物体擦除跑通

启动服务：

iopaint start --model=lama --device=cpu --port=8080

打开assets/unwant_object.jpg，用画笔涂抹画面中央的物体，点击处理。预期是物体消失、背景自然填充。

如果填充出现斑驳色块，多半是笔刷没涂满，把笔刷调大、边缘多圈一圈。

场景 3：文字擦除干净

加载assets/unwant_text.jpg，涂抹画面上的文字区域。预期文字被擦除后不留残影。

如果边缘还有"鬼影"，换 diffusion 类模型再试一次，它对大面积涂抹更稳。

IOPaint 更新卡住时，我替你踩过的坑

坑 1：脚本窗口一闪而过。原因是权限不足，脚本没跑完就退出了。解法：右键脚本，选"以管理员身份运行"。

坑 2：下载慢得像在等快递。默认走的是 pypi 官方源，国内访问不稳定。这个坑我当年也栽了。好在win_setup_cn.bat里已经配好清华和腾讯双镜像，直接运行它重建环境即可。

坑 3：更新完启动报错，提示依赖缺失或 conda 路径错误。原因是环境在迁移过程中损坏，半新半旧。解法：在激活的环境里执行

conda-unpack iopaint install-plugins-packages

前者修复打包路径，后者补齐插件依赖。

坑 4：命令行中文全是方块。这是 cmd 默认编码问题，执行chcp 65001切到 UTF-8 就好。

提示：如果还报错说模型下载超时，说明启动时没走模型镜像。用仓库里带镜像配置的 win_start_cn.bat 启动，别自己手敲命令。

这次版本升级对你最实际的 3 个影响

对象替换：以前只有 SD 系列 inpainting 模型可用，现在 PowerPaint V2 支持局部重绘，换掉图中某样东西更听话（源码见 iopaint/model/power_paint/v2/）。
文字编辑：以前没法往图里写中英文，现在 AnyText 模型可以在擦除后直接绘制文字（源码见 iopaint/model/anytext/）。
环境修复：以前插件依赖要一个个手动装，现在一条iopaint install-plugins-packages全部处理完。