Z-Image-Turbo输出文件保存在哪？路径全知道
你刚跑通了第一张图，终端上跳出那行醒目的成功！图片已保存至: /root/result.png，心里一喜——可下一秒就愣住了：这个/root/result.png到底在哪儿？怎么在 Jupyter 文件浏览器里找不到？想发给同事、传到手机、或者批量处理下一批图，结果连文件影子都摸不着？
别急，这不是你操作错了，而是 Z-Image-Turbo 镜像的默认行为藏了几个“隐形约定”：它不把图存在你习惯的桌面或下载目录，也不自动弹出预览窗口，更不会帮你同步到云盘。它的输出路径看似简单，实则牵扯到模型缓存机制、Jupyter 文件系统权限、以及 Linux 用户空间隔离逻辑。
这篇文章不讲原理、不堆参数，只做一件事：把 Z-Image-Turbo 生成的所有文件——无论你用命令行、脚本还是 ComfyUI——真正落盘的位置、查看方式、修改方法、迁移技巧，一次性说透、写全、标清楚。
1. 默认输出路径：不是“当前目录”，而是“用户根目录”
很多新手会误以为python run_z_image.py --output "mycat.png"会把图存到当前.py文件所在文件夹。但实际运行后，在 Jupyter 的左侧文件树里刷新十遍也找不到mycat.png——因为 Z-Image-Turbo 的默认工作路径，并不是你打开终端时所在的目录，而是 Linux 系统为 root 用户分配的主目录：/root。
1.1 为什么是/root，而不是./或/home/xxx？
镜像基于容器化部署，默认以root用户身份启动所有服务。而 Jupyter Notebook 和终端 shell 的默认$HOME环境变量，就是/root。这意味着：
- 所有未指定绝对路径的
--output参数（如"result.png"），都会被解释为/root/result.png - 即使你在
/workspace/my_project/下运行脚本，只要没加/开头，输出仍落在/root/ /root是 root 用户的专属家目录，普通用户（如 jupyter）默认无权访问，所以 Jupyter 文件浏览器默认不显示/root目录
验证方法：在任意终端中输入
pwd查看当前路径，再输入echo $HOME，你会发现两者很可能不同；接着执行ls -la /root，就能看到你的生成图是否已躺在那里。
1.2 实际路径对照表（含常见误操作）
你写的--output参数 | 实际保存位置 | 是否能在 Jupyter 文件浏览器中直接看到？ | 说明 |
|---|---|---|---|
"result.png" | /root/result.png | 否（需手动跳转） | 最常见默认路径，也是最容易“丢图”的地方 |
"./output/result.png" | /root/./output/result.png→ 即/root/output/result.png | 否（/root/output/不在默认浏览范围） | ./仍相对于/root，不是脚本所在目录 |
"/workspace/output/cat.png" | /workspace/output/cat.png | 是（/workspace是 Jupyter 默认挂载的可读写目录） | 推荐写法：显式使用绝对路径指向安全区 |
"../data/img.png" | /root/../data/img.png→ 即/data/img.png | 否（/data通常不存在或不可写） | 路径越界，可能报错 Permission denied |
关键提醒：
/root目录虽可写，但Jupyter Web 界面默认不向用户暴露该路径，这是出于安全隔离设计。你不能靠点几下鼠标就进去——必须用命令行或路径跳转才能访问。
2. 如何快速定位并查看已生成的图片？
既然图默认在/root，那怎么把它“捞出来”？下面提供三种零门槛、无需安装新工具的方法，按推荐顺序排列：
2.1 方法一：在 Jupyter 中直接跳转到/root（最便捷）
Jupyter 文件浏览器支持手动输入路径跳转：
- 在左侧文件列表顶部，找到地址栏（显示类似
/root/workspace的路径） - 双击该路径文本，使其变为可编辑状态
- 将整段路径替换为：
/root - 按回车键确认
你会立刻看到/root目录下的全部内容，包括result.png、china.png等所有你用脚本生成的图片。点击即可预览、右键下载、或拖拽到其他文件夹。
小技巧：首次跳转后，Jupyter 会在左侧“最近访问”中记住
/root，下次一点即达。
2.2 方法二：用终端命令快速确认与复制
如果你更习惯命令行，三行命令搞定定位+验证+转移：
# 1. 查看 /root 下所有 PNG 文件（确认是否存在） ls -l /root/*.png # 2. 查看最新一张图的完整路径和大小（验证是否生成成功） ls -lt /root/*.png | head -n 1 # 3. 把最新图复制到 workspace（这样就能在 Jupyter 浏览器里直接看到了） cp "$(ls -t /root/*.png | head -n1)" /workspace/执行完第3步，刷新/workspace目录，你的图就出现在眼前了。
2.3 方法三：修改 Python 脚本，让图“主动出生”在可见区
与其每次手动搬图，不如从源头解决——强制输出到 Jupyter 默认可见的/workspace目录。
打开你正在用的run_z_image.py，找到这行代码：
parser.add_argument("--output", type=str, default="result.png", help="输出图片的文件名")把它改成：
parser.add_argument("--output", type=str, default="/workspace/result.png", help="输出图片的绝对路径（推荐）")同时，为防目录不存在，再在image.save(...)前加一行创建父目录：
import os os.makedirs(os.path.dirname(args.output), exist_ok=True) image.save(args.output)改完保存，下次运行python run_z_image.py，图将直接生成在/workspace/result.png，Jupyter 左侧文件树里一眼可见、一点即下。
3. ComfyUI 用户特别注意：输出路径由工作流决定，非固定
如果你用的是 Z-Image-ComfyUI（而非纯脚本），那么图片保存位置不由 Python 脚本控制，而由 ComfyUI 工作流中的 SaveImage 节点配置决定。
3.1 默认 ComfyUI 输出路径是哪里？
Z-Image-ComfyUI 镜像中，预置工作流（如Z-Image-Turbo Text2Img.json）里的SaveImage节点，其filename_prefix参数默认值为：
ComfyUI_output这个前缀会被拼接到 ComfyUI 的内置输出目录后，最终路径为：
/root/ComfyUI/output/ComfyUI_output_00001.png注意：这个路径同样位于/root下，Jupyter 文件浏览器默认不可见。
3.2 如何让 ComfyUI 图片也“落地可见”？
有两种可靠方式，任选其一：
方式 A：修改工作流节点（推荐给常用户）
- 在 ComfyUI 界面中，点击右上角
Load→ 选择你正在用的工作流.json文件（如/workflows/Z-Image-Turbo Text2Img.json） - 找到名为
SaveImage的节点（图标为磁盘） - 点击该节点，在右侧参数面板中，将
filename_prefix改为：/workspace/comfy_output - 点击左上角
Save，保存为新工作流（如Z-Image-Turbo-Visible.json） - 下次加载此工作流，所有图将直接存入
/workspace/comfy_output_00001.png
效果：生成即可见，无需跳转，适合批量出图场景。
方式 B：全局修改 ComfyUI 配置（适合进阶用户）
编辑 ComfyUI 主配置文件：
nano /root/ComfyUI/custom_nodes/ComfyUI-Manager/config.json添加或修改字段：
{ "save_output_path": "/workspace/comfy_images" }然后重启 ComfyUI 服务（执行./1键启动.sh）。此后所有SaveImage节点，若未显式设置路径，均会 fallback 到该目录。
4. 高级技巧：统一管理所有输出，避免文件散落
当你要同时跑脚本、ComfyUI、甚至未来接入 API 服务时，图片可能分散在/root、/workspace、/root/ComfyUI/output多个位置。这时建议建立一个集中输出枢纽目录，一劳永逸：
4.1 创建统一输出目录（一步到位）
在终端中执行：
mkdir -p /workspace/ai_outputs/z_image_turbo这个目录天然可见、可写、可共享，且符合工程习惯。
4.2 三类调用方式的推荐写法汇总
| 调用方式 | 推荐--output或节点配置 | 说明 |
|---|---|---|
| 命令行脚本 | --output "/workspace/ai_outputs/z_image_turbo/cat_$(date +%s).png" | 加时间戳防覆盖，路径绝对清晰 |
| ComfyUI 工作流 | filename_prefix = "/workspace/ai_outputs/z_image_turbo/comfy" | 所有图自动归集，命名带序号 |
| Python API 调用 | 在代码中硬编码output_path = "/workspace/ai_outputs/z_image_turbo/api_result.png" | 与业务逻辑解耦，路径可控 |
优势：后续做批量重命名、格式转换、上传 OSS、生成 HTML 画廊，都只需操作这一个目录，不用满系统
find。
5. 常见问题速查：为什么我找不到图？一文扫清所有盲区
| 现象 | 最可能原因 | 快速排查命令 | 解决方案 |
|---|---|---|---|
| 运行成功但 Jupyter 里完全看不到任何 PNG 文件 | 图存在/root/，而你没跳转过去 | ls /root/*.png | 双击路径栏输入/root回车 |
Permission denied错误，无法保存到/workspace | 当前用户不是 root，或目录权限异常 | ls -ld /workspace | 执行chown -R root:root /workspace（仅限镜像内） |
| ComfyUI 显示“Saved”但目录里没有文件 | SaveImage节点被禁用（灰色）或连接断开 | 检查节点是否高亮、连线是否完整 | 重新连接LATENT或IMAGE输出到SaveImage输入 |
| 图片生成了，但打开是黑屏或损坏 | 显存不足导致图像张量截断 | nvidia-smi查看 GPU 内存 | 降低分辨率至768x768，或增加--lowvram参数 |
| 想把图发微信/钉钉，但下载按钮灰掉 | Jupyter 未启用文件下载功能（极罕见） | jupyter notebook list确认服务状态 | 重启 Jupyter 服务，或改用终端wget+ 临时分享链接 |
终极保底方案：不管图在哪，只要终端能运行，就一定能拿出来。记住这条万能命令：
# 把 /root 下最新 PNG 打包成 zip，供下载 cd /root && zip -r latest_images.zip *.png && cp latest_images.zip /workspace/然后去
/workspace下载latest_images.zip，100% 可用。
6. 总结：掌握路径，就是掌握主动权
Z-Image-Turbo 的强大，不该被一个“文件去哪儿了”的小问题卡住。回顾本文核心结论：
- 默认路径是
/root/xxx.png，不是当前目录，也不是/workspace—— 这是绝大多数“找不到图”的根源； - Jupyter 文件浏览器默认不显示
/root，但支持手动跳转—— 双击路径栏输入/root是最快捷的“寻图术”； - 脚本用户请改
--output为绝对路径（如/workspace/out.png）—— 一劳永逸，告别搬运； - ComfyUI 用户请修改
SaveImage节点的filename_prefix—— 让可视化工作流真正“看得见、拿得到”； - 建立
/workspace/ai_outputs/类统一枢纽目录—— 面向未来，支撑脚本、UI、API 多路输出协同。
技术的价值，从来不在参数多炫酷，而在于能否稳定、确定、可预期地交付结果。当你清楚知道每一张图确切躺在哪一行路径里，你就已经跨过了从“能跑通”到“真可用”的关键门槛。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
