IOPaint安装教程：Windows从下载到一键去水印的保姆级AI修图实战-平芜编程栈

IOPaint安装教程：Windows从下载到一键去水印的保姆级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修图工具，专门用于图像修复：去除水印、多余物体、路人，甚至能用生成式模型智能替换画面里的任何东西。抱着试试看的心态，我从下载到做出第一张干净的图片只花了不到半小时。这篇 IOPaint安装教程，就把完整过程一步步讲给你听。

安装前需要准备什么？一张自查清单就够了

先别急着动手，花两分钟确认下面几件事，能帮你少踩很多坑：

系统：Windows 10 或 11，64 位系统即可；
磁盘空间：建议预留 10GB 以上，模型文件比较大；
Python：推荐 3.10.x 版本，与项目依赖最兼容；
网络：能正常访问网络即可，脚本内置了国内镜像，下载速度不用担心；
显卡（可选）：有 NVIDIA 独立显卡体验更佳，没有也能用 CPU 跑，只是稍慢。

都确认好了？那我们正式开始。

从零开始：像拼乐高一样搭好运行环境

整个安装过程可以拆成三个小步骤，每一步都有对应脚本代劳，你基本只需要"双击"和"等待"。

第一步，把项目拿到本地。打开命令行，输入：

git clone https://gitcode.com/GitHub_Trending/io/IOPaint

如果还没有 Git，也可以直接在网页下载项目压缩包解压，效果一样。

第二步，运行官方准备好的安装脚本。进入scripts/user_scripts目录，找到win_setup_cn.bat，双击运行即可。这个脚本会帮你完成三件麻烦事：

自动配置 Python 环境与依赖库；
内置清华、腾讯云等国内镜像源，下载 PyTorch 这类大文件不再龟速；
自动设置HF_ENDPOINT等环境变量，模型下载也走国内通道，并带智能重试，网络波动时最多自动重试 5 次。

💡提示：建议以管理员身份运行脚本，避免环境变量写入失败；装完后重启一次命令提示符，让配置生效。

第三步，启动你的 AI修图工作台。在命令行里敲下这一条命令：

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

第一次启动会下载模型，耐心等一会儿。看到提示后，浏览器打开http://localhost:8080，你就正式进入 IOPaint 的 Web 界面了。

第一次上手：三分钟去掉一张照片的水印

界面比你想象中简单，左侧是操作面板，中间是画布。我们来做第一次实战——去水印：

把带水印的图片拖进界面；
用画笔工具沿着水印文字轻轻涂一遍，把要清除的区域盖住；
右侧选择模型（默认 LaMa 就很适合去除类任务）；
点击"运行"，几秒钟后见证奇迹。

上面两张图是同一张照片处理前后的对比：密密麻麻的版权水印被干净利落地移除，人物和画面细节几乎没有损失。这就是 AI修图的魅力——你不需要会 PS，涂一下、点一下，剩下的交给模型。

进阶玩法：从一次修复到批量处理

尝到甜头之后，你会发现 IOPaint 能做的事远不止去水印。

去除多余物体与路人。涂掉画面里碍事的电线杆、杂物，或者背景里的陌生人，效果同样自然：

批量处理大量图片。如果你有几十张图要统一清理，IOPaint 也提供了命令行批量模式，一条命令就能跑完整个文件夹：

iopaint run --model=lama --device=cpu --image=图片目录 --mask=蒙版目录 --output=输出目录

启用 GPU 加速。电脑有 NVIDIA 独显的话，把启动命令里的--device=cpu换成--device=cuda，处理速度会提升好几倍。

玩玩插件生态。项目里iopaint/plugins/目录内置了丰富的插件：Segment Anything 可以精准交互式分割物体，RemoveBG 一键抠背景，RealESRGAN 做超分放大，GFPGAN 修复人脸。想离线使用的话，首次下载的模型会缓存在C:\Users\你的用户名\.cache\huggingface，把缓存一起拷贝，就能在没有网络的电脑上继续用了。

常见问题答疑（FAQ）

问：下载太慢或者老是失败怎么办？用win_setup_cn.bat脚本安装，它已经内置国内镜像和自动重试；如果还是失败，检查磁盘空间是否充足，然后删掉缓存目录再跑一次。

问：装完后提示"找不到 iopaint 命令"？多半是环境变量没生效。重启命令提示符，或重新以管理员身份运行一次安装脚本即可。

问：电脑没有独显，能用吗？完全可以。CPU 模式下模型跑得稍慢，但去水印这类小区域任务通常几秒到十几秒就能完成。

问：LaMa 模型效果不满意，能换吗？可以。启动命令里换掉--model参数即可，例如--model=lama换成其他内置模型，详细说明都写在scripts/README.md里。

写在最后

回顾一下，你已经完成了三件事：把 IOPaint 装进电脑、成功启动 Web 界面、亲手做出第一张去水印的干净图片。从一个 AI修图新手到能独立处理照片，只花了不到半小时。接下来，建议你打开web_app/目录里的说明文档，或者去体验一下刚提到的插件，把更多好玩的图像修复场景变成日常。装好了就动手试试吧，你的下一张照片，可能就是朋友圈里最干净的那一张。

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