知仓学习社知仓学习社
用户名/路径含非 ASCII 字符或空格导致安装与启动失败 / 全站资源搜索
搜索 更新 2026-10-02
报错 005 安装、启动与运行环境 有来源可查

用户名/路径含非 ASCII 字符或空格导致安装与启动失败

报错原文（原样） 
& : The term 'C:\Users\ukasz\AppData\Local\Programs@comfyorgcomfyui-electron\resources\uv\win\uv.exe' is not recognized as the name of a cmdlet, function, script file, or operable program.
检索关键词 The term、is not recognized as the name of a cmdlet、CommandNotFoundException、Failed to create virtual environment: exit code -999、路径含中文、用户名含中文、路径含空格、纯英文路径
先看这一句 安装或启动时日志里路径被截断在被空格或特殊字母处（如 \Paul、C:\Users\ukasz\ 少了 Ł），报命令找不到或虚拟环境创建失败。
适用版本 桌面版 0.3.15 一带的路径空格问题已在 0.3.18 修复；非 ASCII 路径与自定义安装路径仍需自行规避 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、ComfyUI Desktop

现象与触发场景

常见触发场景：

  • Windows 用户名含中文或含空格（如 Paul Kroll）
  • 用户目录名含 Ł 等非 ASCII 字母
  • 把便携版解压到含中文/空格的目录
  • 桌面版安装在含空格的路径（含 Program Files）

根因

  • 启动器把路径拼进命令行时未正确加引号，遇到空格路径被拆成两段，导致后半段被当成参数或命令名
  • 非 ASCII 字符在命令行/日志编码链路上丢失或替换，拼出的路径实际不存在
  • 中文社区的通用经验是路径必须是纯英文、无空格，否则服务无法启动或读取文件失败

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 把 ComfyUI 放到纯英文、无空格、无中文的浅层路径
    例如 D:\ComfyUI_windows_portable。不要放在桌面、OneDrive 同步目录、含中文的用户目录或含空格的 Program Files 下。
  2. 桌面版：升级到已修复版本或改安装路径
    官方维护者 rhuang 在论坛中确认“路径含空格的错误已在 0.3.18 处理”，并得到报告者确认已解决。旧版应升级；升级后仍失败则改用便携版。
  3. 确认真实路径与日志中路径一致
    如果日志里的路径和你磁盘上的路径不一样（少字符、多空格），说明是编码/引号问题而不是文件真的丢了。此时不要反复重装，先换到纯英文路径。

验证是否修好

安装/启动日志中不再出现被截断的路径，虚拟环境创建成功，ComfyUI 界面能打开；节点安装也不再报路径不存在。

补充说明

error_text 取自官方论坛帖原文（含因 Ł 被吞掉而产生的 ukasz 路径）。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [13] （官方论坛）　Can't install ComfyUi, probably because of the Polish letter Ł in the 　https://forum.comfy.org/t/cant-install-comfyui-probably-because-of-the-polish-letter-l-in-the-file-path/1248
  2. [14] （官方论坛）　Error: Failed to create virtual environment: exit code -999　https://forum.comfy.org/t/error-failed-to-create-virtual-environment-exit-code-999-with-the-issue-pretty-obvious-at-the-end/390
  3. [15] （官方论坛）　Can't install ComfyUI 0.3.15　https://forum.comfy.org/t/cant-install-comfyui-0-3-15/483

这条报错要用到的东西

按本条报错所属的类别（安装、启动与运行环境）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载
节点库装扩展之后出问题的，多半是节点依赖没装全 板块

同一类别的其他条目

【001】双击 run_nvidia_gpu.bat 窗口一闪而过：c10.dll 缺失，需要安装 VC++ 运行库 有来源 【002】端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净 有来源 【003】torch 加载失败：OSError [WinError 1114] 动态链接库(DLL)初始化例程失败 c10.dll 有来源 【004】便携版找不到内嵌 Python / 路径不对：'python' 不是内部或外部命令、系统找不到指定的路径 有来源 【006】Torch not compiled with CUDA enabled：装的是 CPU 版 torch 或 torch 与驱动不匹配 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库