IOPaint 安装实战：Windows 下 15 分钟装好免费 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 图像修复工具，可擦除照片中的水印、路人或杂物，也能用扩散模型智能重绘局部画面。本文面向 Windows 新手，带你约 15 分钟完成 IOPaint 安装与启动，附排坑手册和进阶技巧，读完即可上手日常修图。
一、安装前自查清单
动手前花 2 分钟核对以下条件，能避开 80% 的安装失败。多数翻车集中在两处：下载走国外源导致超时，以及普通权限写不进环境变量。
| 检查项 | 标准 | 说明 |
|---|---|---|
| Python 版本 | 3.10.x | 项目推荐版本；项目自带 conda 安装目录installer/可跳过手工配置 |
| 磁盘空间 | C 盘 ≥ 10GB | 依赖 + 模型文件体积不小 |
| 网络环境 | 可访问国内镜像 | 安装脚本已内置清华、腾讯云镜像源 |
| 管理员权限 | 需要 | 配置系统级环境变量必须 |
| GPU（可选） | NVIDIA 显卡 | CPU 也能跑，GPU 速度更快 |
二、三步完成安装：克隆、跑脚本、验配置
- 克隆项目到本地：
git clone https://gitcode.com/GitHub_Trending/io/IOPaint cd IOPaint/scripts/user_scripts右键
win_setup_cn.bat，选择"以管理员身份运行"。脚本已内置清华 + 腾讯云双镜像源，并会自动安装 PyTorch 与 IOPaint 本体。类比一下：这一步相当于把国际快递改由国内仓发货，下载速度通常能提升一个量级。新开一个命令行，验证镜像源已生效：
pip config list看到 extra-index-url 指向pypi.tuna.tsinghua.edu.cn或腾讯云域名即配置成功。若为空，回到第 2 步确认是以管理员身份运行的。
三、排坑手册：现象、原因、修复
1. 脚本窗口一闪而过，或装完变量没生效⚠️ 原因：未以管理员身份运行，环境变量写入被拦截。 修复：右键脚本 → "以管理员身份运行"，装完重开一次命令行再验证。
2. pip 安装长时间无进度或超时原因：走了默认国外源。 修复：确认运行的是带_cn后缀的国内版脚本；若手动装依赖，追加参数-i https://pypi.tuna.tsinghua.edu.cn/simple。
3. 启动报错：磁盘空间不足或 Python 版本冲突原因：C 盘剩余低于 10GB，或系统 Python 与依赖不匹配。 修复：清理磁盘后重试；仍失败则删除C:\Users\用户名\.cache\huggingface缓存目录，重跑安装脚本。
4. 模型文件下载卡住原因：模型默认从 HuggingFace 拉取，速度受限。 修复：用win_start_cn.bat启动，它会自动把HF_ENDPOINT指向国内镜像hf-mirror.com。
四、进阶玩法
💡 四条提效技巧，按需取用：
- 离线安装包：在联网机器装好后，压缩整个
installer目录（约 3~5GB），拷到无网机器直接运行win_start_cn.bat。 - 二次缓存提速：模型缓存位于
C:\Users\用户名\.cache\huggingface，重装或换机时复用，时间可从约 20 分钟压到 5 分钟。 - GPU 加速：先装 CUDA 版 PyTorch，启动参数改
--device=cuda，扩散模型推理速度明显提升。 - 常用启动参数：
| 参数 | 作用 | 示例 |
|---|---|---|
--model | 指定模型 | lama |
--device | 计算设备 | cpu/cuda |
--port | Web 端口 | 8080 |
--model-dir | 模型下载目录 | 自定义路径 |
五、首次体验：启动与三大核心功能
iopaint start --model=lama --device=cpu --port=8080浏览器打开http://localhost:8080，模型会在首次启动时自动下载。下面三个功能覆盖绝大多数日常需求 🖌️：
物体去除：上传照片 → 画笔圈选要删的物体 → 点"运行"。LaMa 模型对路人、杂物这类目标效果最好。
水印清理：精确描出水印区域后执行擦除，文字、半透明水印都能干净去掉，不留涂抹痕迹。
智能填充：切换到扩散模型（如 Stable Diffusion），框选区域并输入提示词，AI 会按描述重绘该区域，用于换物、补画，而不只是"抹掉"。
六、收尾
按"自查 → 三步安装 → 排坑 → 体验"这条路线走完，Windows 上的 IOPaint 基本一次就能装好。卡住时优先对照第三章逐条排查，九成问题都能 5 分钟内解决。
资源导航：
- 官方文档：README.md
- 一键安装脚本：scripts/user_scripts/
- 模型实现：iopaint/model/
- 插件系统：iopaint/plugins/
- Web 前端与设置：web_app/src/components/Settings.tsx
【免费下载链接】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），仅供参考
