装不上怎么办：安装与启动排错

装 ComfyUI 最挫败的时刻不是下载慢，而是装完：双击 .bat 黑窗口一闪而过，或者服务起来了浏览器却一片空白。ComfyUI 打不开，八成卡在三处——显卡环境不对、服务没真正起来、浏览器这关出了问题。这节课把安装与启动阶段的常见报错按「原文」逐个给原因和解法：先 60 秒速检定位环节，再对号入座。

解法与命令全部出自官方排错文档、官方便携包脚本与官方仓库；报错原文出自官方文档或 ComfyUI 官方仓库的公开 issue 标题。生成图片阶段的报错（红节点、显存不足）不在本课范围，去 排错总览。

学完你能做什么

• 用 4 条命令在 60 秒内判断：显卡、PyTorch、Python 哪一环出了问题
• 把 ComfyUI 启动失败对号入座：黑窗口一闪而过、CUDA 报错、Linux 库缺失，各自的原因与修法
• 解决 ComfyUI 打不开的三种界面问题：127.0.0.1:8188 连不上、白屏花屏、黑屏崩溃
• 处理桌面版起不来：安全拦截、更新循环、显卡不支持，并找到官方日志文件 app.log
• 学会官方的提问姿势：带齐六项系统信息和完整报错原文再去 GitHub Issues

你现在的困境

• 双击 .bat，黑窗口一闪而过，连报错都没看清，ComfyUI 启动失败得毫无线索
• 黑窗口明明滚了一堆日志，浏览器却打不开 127.0.0.1:8188，或者界面一片黑一片白
• 报错一串英文（Torch not compiled with CUDA enabled？），复制去搜，答案五花八门还互相矛盾

什么时候用这一招

当你需要：

• 修复 安装：Windows 便携包 或 备用安装 里卡住的安装、启动问题
• 在发帖求助前自己先定位：是文件没装对、环境不对、服务没起来，还是浏览器的锅

而且不想：

• 报错就去论坛等回复——60 秒速检能省掉大部分来回
• 把「浏览器该升级了」误判成「ComfyUI 装坏了」，白重装一遍

🎒 开始前的准备

• 走过 安装：Windows 便携包 或 备用安装（卡住没关系，本课就是解卡的）
• 能找到启动 ComfyUI 的那个黑色命令行窗口（便携包 / 手动安装）或 Comfy Desktop 应用（桌面版）
• 桌面版用户：知道左上角 ☰ 菜单 能打开 Desktop Settings
• 一杯水 ☕

💡 桌面版用户看这里

Comfy Desktop 代管 Python 环境和依赖，本页的 Python / pip 类排错主要面向便携包与手动安装用户。桌面版起不来先看第 4 组；要日志直接跳「还是不行？」——官方 app.log 的位置在那里。

核心思路

ComfyUI 是「本地服务 + 网页界面」两层结构。 黑色命令行窗口（或桌面版拉起的实例）是服务本体，浏览器访问 http://127.0.0.1:8188 只是看它的网页。所以「ComfyUI 打不开」要拆成两问：服务起来了吗？浏览器连得上吗？——排错先分层，再看报错。

你的症状	卡在哪一层	去哪组
7z 解压失败、下载不动	文件都没到位	第 5 组
黑窗口一闪而过 / 报错退出	服务起不来（驱动、PyTorch）	第 1、3 组
窗口在，但始终没有 To see the GUI 那行	服务启动中断	第 1 组
有 To see the GUI 行，浏览器打不开	服务 ↔ 浏览器之间	第 2 组
界面白屏、花屏、黑屏	前端 / 浏览器	第 2 组
桌面版打不开、更新后自动退出	桌面应用本身	第 4 组

两个官方给的「万金油」第一步。 官方排错文档对「ComfyUI 起不来」列的前两条快速修复是：核对最低系统要求、把 GPU 驱动更新到最新。官方便携包 README 也有一句直白的话：起不来就更新你的 NVIDIA 驱动。先做这两件事，能消掉一大半安装期报错。

报错原文是最好的搜索词。 黑窗口最后几行、app.log 里最后一段，就是你要的原文——拿它对下面的 H4 标题，或直接复制去 GitHub Issues 搜。

首次排查：60 秒速检

四条命令按顺序跑（在终端 / 命令行里）。便携包用户注意：自带 Python 不在系统 PATH 里，把命令中的 python 换成 .\python_embeded\python.exe（先 cd 进 ComfyUI_windows_portable 文件夹），注释里给了示范。

# 1. NVIDIA 显卡被识别吗？——应该看到显卡型号和驱动版本（AMD / Intel / Apple Silicon 用户跳过）
nvidia-smi

# 2. PyTorch 认得你的 GPU 吗？——应该看到 True
python -c "import torch; print(torch.cuda.is_available())"
#    Windows 便携包用户改用下面这条
#    .\python_embeded\python.exe -c "import torch; print(torch.cuda.is_available())"

# 3. 版本号（报 bug 时官方要这两项）
python -c "import torch; print(torch.__version__)"
python --version
#    便携包用户同上替换 python；官方便携包当前自带 Python 3.13 与 CUDA 13.0 版 PyTorch

你应该看到：第 1 条打印一张显卡信息表；第 2 条打印 True；第 3 条打印 PyTorch 与 Python 的版本号。

哪条断了就从哪条修：第 1 条报错或找不到命令 → 驱动问题（第 3 组）；第 2 条打印 False → PyTorch 环境（第 3 组）；两条都正常但服务起不来 → 第 1 组；服务正常但界面打不开 → 第 2 组。

常见问题排查

启动失败：程序起不来（ComfyUI 启动失败）

双击 .bat 后黑窗口一闪而过，ComfyUI 没起来

原因：启动脚本没能把 ComfyUI 拉起来——最常见的是显卡驱动过旧或缺少运行库。官方在 run_nvidia_gpu.bat 里直接写了一段提示，原文是：

If you see this and ComfyUI did not start try updating your Nvidia Drivers to the latest.
If you get a c10.dll error you need to install vc redist that you can find: https://aka.ms/vc14/vc_redist.x64.exe

解决：

1. 先把 NVIDIA 驱动更新到最新（官方便携包 README 原话：Update your Nvidia drivers if it doesn't start），再双击 .bat
2. 报 c10.dll 错误：装微软 VC++ 运行库，官方给的地址是 https://aka.ms/vc14/vc_redist.x64.exe，装完重试
3. 检查包有没有下对：RTX 20 系及以上必须用标准包，cu126 包只给 GTX 10 系及更旧（见第 5 组「下错安装包」）
4. 还不行：双击 run_cpu.bat 用 CPU 模式试一次——官方说明 CPU 模式任何硬件都能跑，但很慢（官方标注只作最后手段，这里仅用来做排查验证）。能起来，问题就锁定在 GPU 环境，去第 3 组

你应该看到：更新驱动后重双击 .bat，黑窗口稳定停留并滚动日志，最后出现 To see the GUI go to: http://127.0.0.1:8188。

"Torch not compiled with CUDA enabled"

原因：PyTorch 装成了 CPU 版或与显卡不匹配的版本——ComfyUI 想用 CUDA 但这个 torch 没编译 CUDA 支持。手动安装用户最常见；官方仓库 issue 区同款报错的完整形态是 AssertionError: Torch not compiled with CUDA enabled。

解决：

1. 先卸载，再按显卡重装（官方 README 排错项）：

pip uninstall torch
# NVIDIA 稳定版（CUDA 13.0）
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

2. 验证（速检第 2 条）：python -c "import torch; print(torch.cuda.is_available())" 打印 True 才算修好
3. Intel 显卡用户注意：这个报错在 Intel 上是另一回事——XPU 后端不可用，ComfyUI 误当 CUDA 卡处理。别照搬上面的 CUDA 重装步骤，先跑官方检查命令：

python -c "import torch; print('XPU available:', hasattr(torch, 'xpu') and torch.xpu.is_available())"

打印 False 就装 XPU 构建的 PyTorch（官方原命令），官方明确提醒 Intel 不要装 CUDA 版 wheel：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

4. 便携包用户：包里自带匹配好的 PyTorch，一般碰不到这个错；碰到说明环境被动过，可考虑 update\update_comfyui_and_python_dependencies.bat（官方标注仅依赖出问题时使用，运行前先备份整个安装目录）

"cuDNN Frontend error: No valid execution plans built"

原因：Blackwell 架构（RTX 50 系）显卡上，PyTorch 默认的 SDPA 注意力可能选中 cuDNN 后端，而这个架构没有有效的执行计划。官方描述：跑 FLUX 时在 UNet 第一个注意力块就会命中，一张图都出不来。

解决：

1. 启动手写注意力实现，绕过 SDPA 与 cuDNN（官方称这是可靠的修复）：

python main.py --use-split-cross-attention

2. 同时确认 PyTorch 构建：官方注明 Blackwell 需要 CUDA 12.8 及以上版本的构建，cu121 构建在这些卡上完全无法运行——换 CUDA 12.8+ / cu130 构建

💡 别绕弯路

官方明确说过：在启动前用 sitecustomize.py 调 torch.backends.cuda.enable_cudnn_sdp(False) 关掉 cuDNN 后端不管用——这个标志在 CUDA 初始化时不会被保留。启动参数才是可靠修复。

"libcuda.so.1: cannot open shared object file"

原因：Linux 下 PyTorch 把 NVIDIA 库装进了 site-packages/nvidia/，系统默认不会去那里找。官方把 libcuda.so.1、libnccl.so、libnvinfer.so.X 三条同款报错并列为同一类 LD_LIBRARY_PATH 症状。

解决：

1. 把库路径加进环境变量（虚拟环境用户，注意把 python3.12 换成你的版本）：

export LD_LIBRARY_PATH=$VIRTUAL_ENV/lib/python3.12/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# conda 环境改用 $CONDA_PREFIX/lib/python3.12/site-packages/nvidia/nvjitlink/lib

2. 不想手写路径，让 Python 自己找 site-packages（官方原命令）：

PYTHON_PATH=$(python -c "import site; print(site.getsitepackages()[0])")
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# 可能还需要其他 NVIDIA 库目录
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cublas/lib:$LD_LIBRARY_PATH

3. 想一劳永逸：追加到虚拟环境的 activate 脚本或 ~/.bashrc（官方给了两种写法）
4. 验证：python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)"

你应该看到：步骤 4 打印 CUDA available: True 和 CUDA 版本号，随后 python main.py 正常启动。

ComfyUI 打不开：127.0.0.1:8188、黑屏与白屏

"Failed to connect to server"

原因：服务与浏览器之间断了。官方 Connection Issues 给了四条检查：防火墙、端口、VPN、代理；再加上最常见的第五种——服务压根没起来。

解决：

1. 先看黑窗口有没有这行——To see the GUI go to: http://127.0.0.1:8188。没有这行是服务没起来，回第 1 组
2. 有这行但浏览器没自动打开：这不算故障——官方说明通常会自动打开，没自动打开就自己开浏览器访问 http://127.0.0.1:8188
3. 换端口重试（默认 8188，官方建议改试 8189 或 8190）。便携包用户用记事本改 .bat 加参数（官方演示过改 .bat 加启动参数的做法）：

.\python_embeded\python.exe -s ComfyUI\main.py --port 8189 --windows-standalone-build
pause

手动安装用户直接：python main.py --port 8189。

4. 按官方清单过一遍：防火墙放行 ComfyUI、暂时关掉 VPN、不需要代理就关掉代理
5. 开过 --listen 局域网访问的注意：日志会显示 To see the GUI go to: http://0.0.0.0:8188，其他设备要用你的本机 IP 访问（Win + R → cmd → ipconfig 查），127.0.0.1 的意思是「本机」，在手机上不代表你的电脑

你应该看到：浏览器打开 http://127.0.0.1:8188（或新端口），出现节点画布。

界面白屏、花屏或显示异常

原因：浏览器太旧。官方系统要求写明：Chrome 142 及以下版本有已知问题，会导致界面显示异常和性能问题。GitHub issue 区也有白屏相关的公开报告（如 White screen wen loading Comfyui）。

解决：

1. 把 Chrome 升级到 143 或更高版本再打开（官方要求原话）
2. 换了浏览器还白屏：按「还是不行？」收集浏览器控制台报错（F12 → Console），再去 GitHub Issues 搜

你应该看到：升级后 http://127.0.0.1:8188 正常渲染出节点画布。

启动时黑屏或直接崩溃（ComfyUI 黑屏）

原因：官方把「启动崩溃、黑屏、加载失败」归为同一类「ComfyUI Won't Start」症状，给的快速修复就两条：核对最低系统要求 + 更新 GPU 驱动。

解决：

1. 核对系统要求：对照上一课的显卡要求速查表，确认显卡在支持列表（NVIDIA / AMD / Intel Arc / Apple Silicon），没有独显要走 CPU 模式
2. 更新 GPU 驱动（NVIDIA / AMD / Intel 官网，这是官方第二条快速修复）
3. 便携包用户双击 run_cpu.bat（手动安装加 --cpu 启动）再试：CPU 模式任何硬件都能跑、但很慢——能起来就是 GPU 环境问题，去第 3 组接着查
4. macOS 用户：MPS 有问题时官方同样给了 CPU 退路 python main.py --cpu（可用 --force-fp16 --cpu 带内存优化）

你应该看到：更新驱动（或换 CPU 模式）后，服务能完整启动到 To see the GUI go to: http://127.0.0.1:8188，界面不再黑屏。

"Frontend or Templates Package Not Updated"

原因：用 git pull 更新了 ComfyUI 代码，但核心依赖没跟上——前端、工作流模板、节点文档都是独立的 pip 包。依赖更新失败时还会回退旧版，启动日志里会出现 Falling back to the default frontend.。

解决：

1. 在 ComfyUI 的 Python 环境里补装依赖（官方解法）：

pip install -r requirements.txt

2. 国内网络加清华镜像（官方给出）：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 还失败：先 pip list 对版本，再按 ComfyUI/requirements.txt 里写的版本号逐个装（官方提醒别自作主张升到最新版）：

pip install comfyui-frontend-package==<版本号>
pip install comfyui-workflow-templates==<版本号>

4. 权限不够：用管理员权限运行命令行（官方排错步骤之一）

你应该看到：依赖装完，启动日志不再出现 Falling back to the default frontend.，界面功能完整。

显卡与驱动问题

"CUDA error: no kernel image is available for execution on the device"

原因：PyTorch 的 CUDA 构建里没有为你的显卡架构编译内核——构建和显卡不匹配。典型情况：新显卡配了旧构建（如 Blackwell 配 cu121），或老显卡配了太新的构建。

解决：

1. 按官方对照换对包 / 构建：

显卡	该用的
RTX 20 系及以上	标准包 / 构建（CUDA 13.0）
GTX 10 系及更旧	cu126 包（CUDA 12.6，Python 3.12）
RTX 50 系（Blackwell）	CUDA 12.8 及以上构建（官方：cu121 构建完全无法运行）

2. 便携包用户：删掉下错的包，按上一课的选包表重新下载解压
3. 手动安装用户：pip uninstall torch 后装对应版本，再用 python -c "import torch; print(torch.cuda.is_available())" 验证

"HIP error: invalid device function when running ComfyUI"

原因：AMD 显卡架构不在所用 ROCm 构建的支持列表里。官方文档为「不支持的 AMD 显卡」专门给了环境变量覆盖方案。

解决（按架构选一条，官方原命令）：

# RDNA2 或更旧（如 6700、6600）
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py

# RDNA3（如 7600）
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

同时确认 PyTorch 来源正确——Linux AMD 用 ROCm 稳定版：

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

"My GPU is not detected"

原因：桌面版没检测到 GPU——驱动过旧、Linux 缺 CUDA 工具链，或安装类型本身不用本地 GPU（官方 FAQ 列的三种）。

解决：

1. 更新 NVIDIA 驱动
2. Linux 用户确认装了 CUDA toolkit
3. 确认安装类型支持 GPU：Standalone 和 Git Clone 支持；Cloud 连接用的是远程 GPU
4. 命令行验证（速检第 1 条的加强版，官方原命令）：

nvidia-smi
nvidia-smi --query-gpu=driver_version --format=csv

你应该看到：nvidia-smi 打印显卡型号和驱动版本；桌面版能正常检测并使用 GPU。

Comfy Desktop 桌面版问题

"The app won't start after installation"

原因：平台相关的启动拦截——权限、安全设置或缺库。官方 FAQ 按平台给了四条。

解决：

1. Windows：用管理员身份运行一次
2. macOS：弹安全警告时，去 系统设置 → 隐私与安全性，点 仍要打开（Open Anyway）
3. Linux：确认装了 FUSE 2（sudo apt install libfuse2）；若是 Ubuntu 24.04+ 的 AppArmor 拦住了 Electron 沙箱，加 --no-sandbox 重试——⚠️ 官方警告：该参数会禁用每个进程的 Electron 沙箱，只在沙箱启动失败时用
4. 去 下载页 确认拿到的是最新版本

你应该看到：按平台处理后，Comfy Desktop 窗口能打开，进入仪表盘或首次设置。

"App is damaged"

原因：macOS 安全机制把应用标记为「已损坏」。官方 macOS 排错条目的第一条就是它。

解决：到 系统设置 → 隐私与安全性 里放行该应用。同页官方条目还有：性能问题授予完全磁盘访问权限；崩溃去「控制台」应用查崩溃报告。

"Comfy Desktop closes by itself after an update (Windows)"

原因：官方确认的 bug——1.0.46 及更早的 Windows 版，更新下载没完成时，应用闪一下更新界面就自己关掉，且每次启动都复现、来不及自修复。1.0.47 起已修复。

解决：手动安装最新版（官方恢复步骤）：

1. 下载最新 Windows 安装器（或从下载页获取）
2. 直接运行安装，不需要先卸载旧版
3. 启动 Comfy Desktop

你应该看到：应用正常打开不再自动退出——你的安装实例、模型和设置都还在（官方确认保留）。

"Unsupported device"

原因：Windows 版 Comfy Desktop 只支持 NVIDIA CUDA 显卡——官方排错文档原话。AMD / Intel 显卡装 Windows 桌面版就会碰到它。

解决：AMD / Intel 显卡的 Windows 用户改走另外两条官方路线：

• 官方便携包：AMD 包（ComfyUI_windows_portable_amd.7z）或 Intel 包（ComfyUI_windows_portable_intel.7z），见上一课选包表
• 手动安装（按显卡装对应 PyTorch）

下载失败、卡在 Maintenance 页面或提示磁盘不足

原因：桌面版要从 GitHub / PyPI 拉文件，网络或镜像不对会卡住；新建实例时还会强制检查磁盘空间。

解决：

1. 卡在 Maintenance 页面：官方建议检查镜像设置——中文界面可在设置里开 Use Chinese Mirrors (Git & PyPI)：Git 仓库改走 gitcode.com、PyPI 走阿里云与腾讯镜像，官方说明这在中国大陆更快
2. Low Disk Space 只是警告，选 Continue Anyway 可继续（或换个安装路径）；Not Enough Space for Template Models 会挡住该模板——换轻量工作流或清理磁盘
3. 安装器失败：官方建议以管理员运行 + 确保至少 15GB 磁盘空间；桌面版每次独立安装官方要求至少 4.85GB

下载与解压问题（ComfyUI 装不上）

7z 解压失败或解压后文件不全

原因：Windows 会给从网上下载的文件加「锁定」标记，导致解压出问题。官方 README 对此有专门一句：If you have trouble extracting it, right click the file -> properties -> unblock。

解决：

1. 右键 .7z 文件 → 属性 → 勾选「解除锁定（Unblock）」→ 确定，重新解压
2. 仍不行：换 7-Zip 解压（官方也说明较新的 Windows 资源管理器可直接解压）

你应该看到：解压出完整的 ComfyUI_windows_portable 文件夹，里面有 run_nvidia_gpu.bat、python_embeded 等。

下错了安装包：给新卡下了 cu126 包（或反之）

原因：官方按显卡出了多个包，唯一容易选错的就是 NVIDIA 的两个。cu126 包只给 GTX 10 系及更旧显卡，官方用大写强调：DO NOT USE THIS ON NEWER 20 SERIES AND ABOVE GPUS。

解决：核对文件名重下（完整对照表见上一课）：

你的显卡	正确的文件名
RTX 20 系及以上	ComfyUI_windows_portable_nvidia.7z
GTX 10 系及更旧	ComfyUI_windows_portable_nvidia_cu126.7z
AMD	ComfyUI_windows_portable_amd.7z
Intel	ComfyUI_windows_portable_intel.7z

你应该看到：新包解压后双击对应 .bat，启动不再报架构类错误。

下载慢或下载失败（国内网络）

原因：安装包托管在 GitHub Releases——官方文档提到，中国大陆用户可能需要配置代理才能稳定访问 GitHub 仓库。下载慢不是你操作错了。

解决：

1. 配置代理访问 GitHub（官方方案）
2. 桌面版用户：开启中文镜像（Git 走 gitcode.com、PyPI 走阿里云与腾讯镜像，见上一条）
3. 手动装依赖时 pip 换清华镜像（官方给出）：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
4. 只从官方渠道拿包：GitHub Releases 与 comfy.org/download

还是不行？

先收集证据再提问。 官方 bug 报告模板要的系统信息一共六项，先备齐：

信息项	怎么拿
操作系统	Windows: systeminfo | findstr /C:"OS Name" /C:"OS Version"；macOS/Linux: uname -a
ComfyUI 版本	界面 Settings → About 页
Python 版本	python --version
PyTorch 版本	python -c "import torch; print(f'PyTorch: {torch.__version__}')"
GPU 型号与驱动	Windows: wmic path win32_VideoController get name；Linux: lspci | grep VGA；驱动版本 nvidia-smi --query-gpu=driver_version --format=csv
安装方式	Desktop / Portable / Manual / comfy-cli

再加三样：控制台完整报错原文、浏览器控制台报错（F12 → Console）、能复现问题的工作流 .json 与自定义节点列表。

桌面版用户先找日志。 Comfy Desktop 写滚动日志 app.log，最快入口是 Desktop Settings → Logs → Diagnostics → Open logs folder（☰ 菜单进设置）。默认位置：

平台	日志文件夹
Windows	%APPDATA%\Comfy Desktop\logs
macOS	~/Library/Logs/Comfy Desktop
Linux	~/.config/Comfy Desktop/logs

看 app.log（旧会话在带时间戳的 app.log_*.log 里）。要看 ComfyUI 进程本身的输出，打开实例的 Manage 面板用 Terminal 标签。

去哪里问（官方渠道对照）：

渠道	什么问题去
ComfyUI GitHub Issues	ComfyUI 核心问题
Comfy-Desktop Issues	桌面版问题
ComfyUI_frontend Issues	前端问题
自定义节点的作者	custom node 问题（官方：找具体节点开发者）
官方论坛 / Discord / r/comfyui	社区求助

💡 提问前官方建议的三件事

先搜 GitHub Issues 和论坛确认不是已知问题；用默认工作流测一次排除工作流因素；用 comfy-cli 装的话先 comfy node update all。生成阶段的报错排查（自定义节点、模型加载、显存）从 排错总览 进。

检查点 ✅

• 60 秒速检四条命令我都跑过，知道哪条不对
• 黑窗口一闪而过时，我知道顺序：先更新显卡驱动 → 报 c10.dll 就装 VC++ 运行库 → 核对包下对没有
• 127.0.0.1:8188 打不开时，我先确认黑窗口里有没有 To see the GUI 那行，再查防火墙 / VPN / 换端口
• 界面白屏花屏，我第一反应是查 Chrome 版本（143 及以上）
• 提问时我会带齐六项系统信息 + 完整报错原文 + app.log（桌面版）

本课小结

✅ ComfyUI 打不开先分层：文件装齐了吗（第 5 组）→ 服务起得来吗（第 1、3 组）→ 浏览器连得上吗（第 2 组）→ 桌面版本身正常吗（第 4 组）。

✅ 两个官方万金油：核对系统要求 + 更新 GPU 驱动，先做这两件事再细查。

✅ 提问姿势：六项系统信息 + 报错原文 + 日志，去对应的官方 GitHub 仓库或社区。

关键信号回顾：

信号	在哪一层	第一步
黑窗口一闪而过	启动	更新显卡驱动；c10.dll → 装 VC++ 运行库
Torch not compiled with CUDA enabled	PyTorch 环境	卸载 torch 按显卡重装
有 To see the GUI 行但打不开	服务 ↔ 浏览器	手动访问；查防火墙 / VPN / 换端口
白屏、花屏	浏览器	Chrome 升到 143+
App is damaged	macOS 安全	隐私与安全性里放行
Maintenance 页面卡住	网络	检查镜像设置 / 开中文镜像

下一课预告

环境稳了，下一步去 模型放哪里：models 目录与 extra_model_paths 详解。

你会学到：

• models 目录的完整结构和各子目录放什么
• checkpoint、VAE、LoRA 怎么对号入座
• 用 extra_model_paths.yaml 在多个安装之间共享模型

想直接出图的同学，放好模型后就去 第一次生图。

相关教程

• 排错总览：出问题先看这页（60 秒速检）
• 显存不足与卡顿：OOM 的系统解法
• 模型放哪里：models 目录与 extra_model_paths 详解