IOPaint 更新指南3 条路径 一张验证清单升级一步到位不翻车【免费下载链接】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/IOPaintIOPaint 是一款流行的本地 AI 图片修补工具能从照片里移除不需要的物体、人物也能做去水印、改文字这些事。官方更新比较频繁新版本通常带来模型优化和 bug 修复但很多人更新时容易翻车脚本窗口一闪而过、下载半天没动静、更新完程序打不开甚至版本号看起来还没变。这篇文章把 IOPaint 更新全流程拆成三条能落地的路径最后再给你一张出问题时的对照清单。更新前先把这 3 件事做了先说结论关干净程序、确认安装目录结构完好、磁盘留出至少 1GB 空间。先把 IOPaint 完全关掉包括后端的控制台窗口。只关浏览器页面还不够如果命令行黑窗口还挂着pip 升级时会报文件被占用的错误更新直接失败。然后看一眼磁盘空间。更新本身要下载几百 MB 的依赖包首次启动还可能补拉模型文件C 盘快满的话先腾一腾别更新到一半断掉。还有一点容易被忽略别挪动或重命名安装目录。IOPaint 一键安装版把内置 Python 环境放在installer\子目录里更新脚本全靠它找环境。目录结构一旦乱了脚本找不到解释器就会闪退——这也是更新后打不开最常见的根源之一。3 条更新路径从省事到彻底先说结论官方更新脚本能跑就用它跑不动进终端手动更新环境坏得彻底就用镜像整包重装。双击官方脚本自动升级打开 IOPaint 安装目录进入scripts\user_scripts双击win_update.bat。脚本会自动激活内置环境把 iopaint 升到最新版黑窗口出现按任意键继续 . . .就说明完成了关掉窗口重新打开程序即可。这是 IOPaint 自动升级最推荐的路径全程零命令行知识。窗口闪退也别慌手动打开 cmdWinR 输入 cmd进安装目录的scripts\user_scripts直接敲win_update.bat执行窗口会停住你能看清它到底死在哪一步。终端手动更新脚本跑不通时用脚本中途卡住、或者跑完版本没变就手动来。先 cd 进安装目录然后依次执行installer\Scripts\activate.bat pip install -U iopaint第一行是关键它激活内置 Python 环境跳过它 pip 会把包装到系统环境下次启动还是老版本。经典的IOPaint 版本不匹配就是这种原因前端显示新号码后端跑的还是旧代码。用镜像整包重装环境坏得彻底时的兜底如果环境本身已经坏了——比如启动报缺依赖、缺哪个包都摸不清——别折腾修补直接跑一键设置脚本重建环境。中文版预设了清华和腾讯镜像IOPaint 下载慢的问题基本解决它会重建依赖、升级 iopaint并把插件包一并装上。装完用 win_start_cn.bat 启动Hugging Face 也走了国内镜像模型下载会快很多。更新后验证 3 个点先说结论版本号、跑一次真实修复、模型加载三关都过才算真的升上去了。第一关查版本号。启动应用点右上角齿轮图标打开设置看关于页的版本号。当前最新版是 1.6.0如果显示的还更低说明更新没生效回到上面检查你走的是哪条路径——九成是漏了激活环境那一步。第二关实际跑一次物体移除。打开仓库自带的示例图用画笔涂掉一个物体点处理结果自然就算通过。这是官方 assets/ 目录里的示例图之一同一目录还有对应的处理后效果对照更新前后对比着看很直观。第三关留意首次启动的模型下载。更新后第一次启动明显变慢多半是在补拉模型文件这属于正常现象如果卡了十分钟以上没进度换用国内 Hugging Face 镜像或者挂代理再试。更新后常见问题的对照清单更新后的问题不复杂八成逃不出下面这四种对着排查就行现象大概率原因解法脚本窗口一闪而过非管理员运行 / 不在安装目录内右键以管理员身份运行或手动进终端跑脚本看报错更新后打不开环境依赖没同步跑 win_setup_cn.bat 修复环境终端中文乱码Windows 命令行默认编码终端里执行chcp 65001切到 UTF-8下载半天没进度没走镜像源用安装脚本里的清华 / 阿里云镜像新版最值得试的 2 个功能先说结论更新完优先试 PowerPaint V2 局部重绘和 AnyText 文本编辑这是近期体感变化最大的两个功能。PowerPaint V2 局部重绘只涂你改的区域其他地方不受影响特别适合修老照片的局部瑕疵、强化某个细节。实现代码在 iopaint/model/power_paint/想折腾模型加载逻辑可以去看。AnyText 文本编辑能精准识别图里的文字直接重写水印、招牌。更新后做去水印和文字替换衔接会更顺滑。上面是最新版 IOPaint 清理水印后的效果原图在 assets/watermark.jpg可以对着看看差异。多久升一次合适小版本多是 bug 修复可以攒着。我的习惯是看到想用的新功能比如 PowerPaint V2 这种才动或者撞上已知在新版修复的 bug 再升。你们一般多久升一次【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考