企业官网建设流程全解析

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 是一款免费的开源 AI 图像修复工具，能把照片里不想要的物体、水印、路人擦掉或替换。本次 1.6.0 版本带来了 PowerPaint V2 局部重绘、AnyText 文字编辑增强和批量处理子目录递归三项能力。这篇文章带你用一条命令完成 IOPaint 更新，再用版本号核对和一次真实擦除测试确认升级成功。

为什么值得现在更新：1.6.0 版本的三个新功能

先看动机。PowerPaint V2 让局部重绘更精准——你只涂抹要改的区域，其余部分不会被波及，修老照片瑕疵、增强局部细节都适用。AnyText 是一套全新的文字识别与编辑引擎，能精准识别图里的文字并改写成你想要的内容，支持多种字体样式，去水印就是它的典型场景。

上面这组对照就是 AnyText 处理前后：带水印的原图交给新版引擎，水印被干净地清理掉了。第三项则是效率层面的改进——批量处理现在可以递归扫描文件夹及其子文件夹里的所有图片，一次任务处理整个照片库。如果你经常批量修图，这三项都值得尽快升级。

IOPaint 更新前的 4 项快速自检

动手之前，花两三分钟过一遍下面这张表，能避免大部分中途失败。

确认无误后，下面两条路线任选其一。

路线一：用 win_update 一键脚本更新 IOPaint（推荐新手）

适合人群：用 Windows 一键安装包装 IOPaint 的用户，不想碰命令行。系统要求：Windows 10/11 64 位，且安装目录结构完整（installer 文件夹存在）。

打开文件资源管理器，找到 IOPaint 的安装目录，进入其中的scripts/user_scripts文件夹，双击运行win_update.bat。脚本会先激活内置的 Python 环境，再通过 pip 把 iopaint 升级到最新版，包体从国内镜像源下载，速度通常不错。运行后命令行窗口会滚动显示下载和安装进度，全部结束时出现"按任意键继续..."的提示——看到这个提示才算更新完成，按任意键关闭窗口即可。

路线二：手动命令行更新 IOPaint（脚本失效时的备选）

适合人群：脚本闪退、卡在下载、或你本来就更习惯手动操作的用户。两条路线的系统要求一致。

按 Win+R 输入cmd回车打开命令提示符，然后依次执行。下面这条命令先切换到 IOPaint 安装目录，请把它替换成你自己的实际安装路径：

cd C:\Program Files\IOPaint

接着激活内置的 Python 虚拟环境（激活后命令行提示符前会出现 installer 字样）：

installer\Scripts\activate.bat

最后这条命令从清华镜像源把 iopaint 升级到最新版，-U表示强制升级：

pip install -U iopaint -i https://pypi.tuna.tsinghua.edu.cn/simple

看到Successfully installed iopaint-x.x.x字样且没有红色报错，就代表升级完成。

怎么选？判断依据就一条：如果你的安装目录里有scripts/user_scripts/win_update.bat且双击能正常跑完，就走路线一，省心；跑不动再切路线二。

更新结果核验：版本号加一次真实功能测试

升级成功不等于装好了，要做两步核验。

第一步核对版本号。启动 IOPaint，点击右上角的齿轮图标打开设置面板，在"关于"页面查看版本信息，确认显示为 1.6.0 或更高——看到这个数字，才说明包确实替换成功了。

第二步做一次真实体验。把 assets 目录里的unwant_object.jpg拖进编辑器，用画笔工具涂抹图中不想要的物体区域，点击处理。涂抹区域被自然补齐、边缘没有明显涂抹感，就说明模型正常加载、核心功能完好。

除了功能，性能也能感受到变化。下面是官方给出的对比数据：

如果版本号和功能测试都通过，这次 IOPaint 升级就算真正落地了。当然，过程中卡住的概率也不小，下面是最常见的几种。

IOPaint 更新失败怎么办：四个高频问题一问一答

双击脚本后窗口一闪而过，这是怎么解决？多半是权限或环境变量问题。右键点击win_update.bat，选择"以管理员身份运行"，窗口就不会立刻关闭，你也能看到它到底报了什么错。

更新时下载进度长时间停在同一个百分比，是不是卡死了？大概率是网络慢而不是卡死。可以编辑脚本里 pip 使用的镜像源，把清华源换成阿里云源https://mirrors.aliyun.com/pypi/simple再试一次，换源后速度通常明显改善。

更新完成后点程序没反应，打不开了，能自救吗？先别重装，大概率是依赖环境在升级时被改乱了。运行scripts/user_scripts里的win_setup_cn.bat，它会重新激活环境并补齐插件依赖，跑完后再启动 IOPaint，通常就能恢复正常。

命令行窗口里中文全是问号或乱码，影响看日志，如何处理？在命令提示符里执行chcp 65001，把控制台编码切到 UTF-8，中文即可正常显示。

更新之后，可以往哪走：项目内真实路径资源

刚上手的话，先读 README.md 了解快速启动和模型下载方式，再翻翻 scripts/README.md 看 Windows 一键安装器的说明，这两份文档覆盖了 90% 的日常使用场景。

想深入的话，iopaint/cli.py 里定义了 download、list、run 等命令行入口，是理解 IOPaint 怎么调度的最短路径；iopaint/plugins/base_plugin.py 则是插件体系的基类，搞懂它你就能给 IOPaint 写自己的插件。

想参与贡献，先看 setup.py 了解包结构和版本定义，再看 scripts/environment.yaml 照着搭一套和官方一致的本地开发环境，然后就可以动手提代码了。

IOPaint 更新到这里就算完整走通了：自检、升级、核验、排障，四步闭环。团队会定期发布功能更新和性能优化，建议每两周到每月抽几分钟看一眼版本动态，别让自己停在旧版太久。你更新之后最想试的新功能是哪一项，欢迎留言聊聊。

【免费下载链接】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