IOPaint 上手完全指南：三步装好这款免费 AI 修图工具，抹掉照片里的多余物体和水印-港品优选

IOPaint 上手完全指南：三步装好这款免费 AI 修图工具，抹掉照片里的多余物体和水印

【免费下载链接】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 图像修复（inpainting）工具：用画笔圈出照片里的水印、路人、杂物，它能自动把这块区域"补"回去；想更进一步的话，还能接入 Stable Diffusion 系列模型做物体替换和外扩画面。本文带你判断安装路径、走完三个落地关卡，最后用一张自检清单确认工具真的能用。

先选安装路径，别急着动手

IOPaint 官方为 Windows 准备了两条路，选对路能省掉大半折腾：

路径 A：一键安装包（推荐新手）适合机器上没有 Conda/Python 环境、或者不想碰命令行的用户。官方提供 Windows 1-Click Installer，双击脚本走完安装，装完直接启动。

路径 B：pip 手动安装适合已经有 Python 环境、想自己控制版本的用户：

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

两条路怎么选，看三点：网络环境（国内网络建议路径 A，脚本已内置镜像源）、显卡情况（有 NVIDIA 显卡可以选 GPU 路径，纯 CPU 也能跑）、磁盘空间（C 盘预留 10GB 以上更稳妥）。

💡 这一节你拿到了什么：一条"按自己情况选路"的判断标准，而不是盲跟着点鼠标。

关卡一：拿到项目与安装脚本

用 git 把项目拉到本地：

git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint/scripts/user_scripts

然后双击win_setup_cn.bat。这个脚本做了三件关键事：把 pip 下载源切成清华 + 腾讯云镜像、安装 PyTorch（cu118 版）和 iopaint 本体、拉取插件依赖。

怎么算成功：脚本跑完停在PAUSE界面、没有红色报错；installer目录下的虚拟环境已激活过。
卡住怎么办：脚本中途断网重连一般会自动继续；反复失败就重新双击一次，已下载的包不会重复拉取。

⚠️ 建议右键"以管理员身份运行"，否则个别环境变量设置可能不生效。

关卡二：让模型下载不翻车

IOPaint 的 AI 模型默认从 HuggingFace 下载，这是国内安装最容易翻车的环节，优化脚本已经替你处理好了：

启动脚本内置镜像：win_start_cn.bat启动时会自动设置HF_ENDPOINT，把模型下载指向国内镜像站，不用手动改任何配置。
缓存复用：下载过的模型会存在C:\Users\你的用户名\.cache\huggingface，第二次启动或重装时直接读本地，几乎秒加载。
想换缓存位置：启动时加--model-dir参数即可，模型目录不默认挤占 C 盘。

✅ 判断标准：终端出现模型加载进度、日志里没刷connection timeout一类错误，就算过了这一关。这一节你拿到了什么：一份"模型下载为什么快、缓存在哪"的完整解释。

关卡三：启动服务并拿到第一张结果图

安装完成后，启动最简单的方式就是双击win_start_cn.bat；命令行党则用：

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

浏览器打开http://localhost:8080，整个 Web 界面就出来了。第一次跑图推荐用LaMa 模型（--model=lama）：专门做擦除任务，CPU 上也能流畅跑，出图快。

操作流程只有四步：上传图片 → 画笔涂掉要消除的区域 → 点运行 → 下载结果图。下面两张就是官方素材里的实际效果：

这一节你拿到了什么：从启动到产出第一张修复图的完整闭环。

跑通后做一次体检

安装"看似成功"和"真的能用"之间，差的就是这几项验证。对着清单逐项过一遍：

检查项	通过信号
服务能起	浏览器能打开`localhost:8080`，终端无红色 Traceback
模型能加载	日志显示模型下载/加载完成，首次出图后后续出图明显变快
出图正常	涂选区域被自然补全，无大块色块、无残留水印
缓存生效	关闭服务重启后，几秒内就进入可编辑状态（模型走本地缓存）

四条全过，说明环境、网络、缓存全部就位，可以放心投入日常使用。

进阶玩法与排障入口

批量处理：处理成批图片时不必一张张点，命令行直接跑：

iopaint run --model=lama --device=cpu \ --image=/path/to/image_folder \ --mask=/path/to/mask_folder \ --output=output_dir

--mask也可以是单个蒙版文件，同一张蒙版套用到所有图片上。

插件扩展：启动时加参数即可解锁额外能力，交互式分割、去背景、超分、人脸修复都有现成开关，比如iopaint start --enable-interactive-seg启用 Segment Anything 交互式抠选，更多参数看iopaint start --help。插件源码在 iopaint/plugins/。

排障三板斧：

启动报依赖错误 → 先确认 Python 是否为 3.10.x；
磁盘告急 → 检查 C 盘剩余空间是否大于 10GB，必要时挪动模型目录；
下载反复失败 → 清掉.cache\huggingface缓存后重跑安装脚本。

资源导航：官方说明 README.md、安装脚本文档 scripts/README.md、模型实现 iopaint/model/、前端源码 web_app/src/。

现在打开终端跑一下安装脚本，十五分钟后你就能在浏览器里抹掉第一张照片里的水印。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析