AUTOMATIC1111 环境配置与基础安装指南
在正式部署前，请确认电脑满足基本硬件要求。建议使用 Windows 10 或更高版本操作系统，并配备至少 8GB 系统内存。最关键的是需要一块支持 CUDA 的 NVIDIA 显卡，这是稳定运行图像生成模型的基石。首先，安装 Python，推荐选择 3.10.6 或 3.10.11 版本，它们与主流依赖库兼容性最佳。安装时务必勾选“Add Python to PATH”选项，以便在命令行中直接调用 python 命令。
接下来需要安装 Git，用于从代码仓库拉取项目文件。访问 Git 官网下载安装程序，按默认设置完成即可。基础软件安装完成后，建议创建一个独立文件夹存放所有相关文件，例如在 D 盘根目录新建名为“stable-diffusion-webui”的文件夹。打开命令提示符，使用“cd”命令切换至该目录，准备执行核心项目克隆操作。
获取项目代码与依赖库安装
在准备好的目录中，通过命令行执行克隆命令，从官方仓库获取 AUTOMATIC1111 WebUI 的最新代码。此过程会将所有必要脚本和配置文件下载到本地。完成后，进入新生成的“webui”文件夹，会看到一个名为“webui-user.bat”的启动脚本。首次运行前，可右键编辑该文件，检查其中的配置参数。
对于国内用户，由于网络环境限制，直接安装依赖可能失败。一个高效的解决方法是修改项目依赖源。编辑“launch.py”或相关配置文件，将 PyPI 索引地址替换为国内镜像源，例如清华源或阿里云源，这能显著提升依赖库的下载速度与成功率。完成源配置后，双击运行“webui-user.bat”脚本，程序将自动安装 PyTorch、Transformers 等核心依赖。此过程耗时较长，请保持网络稳定。
启动器选择与模型文件放置
虽然原生批处理文件即可启动，但使用第三方启动器能获得更优的使用体验和更强的管理功能。目前流行的启动器通常集成一键更新、故障修复、扩展管理以及直观的参数设置界面。下载启动器压缩包后，解压至 WebUI 根目录，按说明文档运行即可。启动器会自动识别已有安装环境。
模型是图像生成的核心资源。将下载好的基础模型文件（通常为 .ckpt 或 .safetensors 格式）放入指定文件夹。具体路径为“webui/models/Stable-diffusion”。放置完成后，在启动器的模型管理界面或 WebUI 左上角的模型选择下拉菜单中，即可看到新添加的模型名称。首次加载大型模型可能需要一些时间，请耐心等待。
显存优化与参数调优
显存不足是运行中最常见的问题。针对不同显存容量的显卡，需进行针对性优化。对于显存低于 8GB 的用户，启动时必须添加低显存优化参数，强制模型在生成过程中将部分数据交换至系统内存，虽然会降低速度，但能保证正常运行。可在启动器的“高级选项”中或直接修改“webui-user.bat”里的“COMMANDLINE_ARGS”变量，添加相关参数即可。
此外，调整生成参数也能有效控制显存占用。降低生成图片的分辨率、减少批处理数量，以及选用更高效的采样器，都能立竿见影地减轻显存压力。在 WebUI 设置页面中，还可启用“交叉注意力优化”选项，进一步优化显存使用。定期清理显存缓存也是一个好习惯，某些启动器提供了该功能的一键按钮。
功能测试与常见问题排查
安装配置完成后，进行一次简单的出图测试以验证所有环节是否正常。在 WebUI 的“文生图”页面，选择已加载的模型，在提示词框中输入简单描述，例如“a cute cat”，采样步数保持默认，点击生成。观察控制台是否有报错信息，并等待生成结果。若成功输出一张小猫图片，则说明核心功能正常。
如果启动失败或生成报错，首先查看命令行窗口中的红色错误信息。常见启动问题包括 Python 路径错误、依赖库版本冲突或端口被占用。可根据错误关键词搜索，大部分问题已有成熟解决方案。对于模型加载失败，检查模型文件是否完整、是否放置在正确目录。保持 WebUI 及其扩展的及时更新，也能避免许多已知的兼容性问题。
