BMC Studio相关FAQ
更新时间: 2026/03/18
在Gitcode上查看源码

2026版本openUBMC Studio FAQ

Q1:登录到社区时提示无法识别OS keyring,登录保持功能无法正常生效

问题现象: 登录到社区时,右下角弹窗提示An OS keyring couldn't be identified for storing the encryption related data in your current desktop environment.,登录保持功能无法正常生效,开启新页面或重启openUBMC Studio时仍为未登录状态

问题原因: 该问题可能与主机的凭证管理服务无法正常工作有关,请确认当前使用的主机是否支持凭证管理

首先确保Windows凭据管理器服务正在运行:

  1. 按下Win + R,输入services.msc并回车。
  2. 在服务列表中找到Credential Manager(凭据管理器),确保其状态为“正在运行”,启动类型建议为“手动”或“自动”。
  3. 如果服务未运行,右键单击选择“启动”。

如果服务是启动的,则有可能当前主机没有权限管理凭证,请确认是否能够管理凭据:

  1. 打开“控制面板”>“用户账户”>“凭据管理器”>“Windows 凭据”。
  2. 确认是否能够正常打开,少数场景下,打开会报错,此时当前用户无权限管理凭据,请尝试提升用户权限

2025版本BMC Studio FAQ

Q1:通过apt源安装仓颉工具链时,执行apt install cangjie-runtime命令报错trying to overwrite '/usr/share/bmc_studio/server/libsecurec.so', which is also in package bmc-studio 1.1.95.250628

**问题现象:**运行apt install cangjie-runtime安装仓颉工具链时报错,报错信息如下

bash
dpkg: error processing archive /var/cache/apt/archives/cangjie-runtime_1.0.0_amd64.deb (--unpack):
 trying to overwrite '/usr/share/bmc_studio/server/libsecurec.so', which is also in package bmc-studio 1.1.95.250628
Errors were encountered during processing:
 /var/cache/apt/archives/cangjie-runtime_1.0.0_amd64.deb
E: Sub-process /usr/bin/dpkg returned an error code (1)

**可能原因:**安装仓颉工具时,旧版本 BMC Studio (1.1.95.250628版本)未卸载。 **处理建议:**请先运行代码

bash
apt update
apt install bmc-studio

安装最新BMC Studio,然后再执行

bash
apt install cangjie-runtime

Q2:安装完成后,运行提示error while loading shared libraries: libcangjie-std-ast.so: cannot open shared object file: No such file or directory

**问题现象:**安装完成后,提示 error while loading shared libraries: libcangjie-std-ast.so: cannot open shared object file: No such file or directory

**可能原因:**未安装 cangjie-runtime

**处理建议:**参考本文安装方式3配置 apt 源,然后在命令行输入命令:

bash
apt install cangjie-runtime

然后重新启动 BMC Studio 即可。

Q3:安装完成后,使用bingo studio命令无法正常拉起BMC Studio窗口

**问题现象1:**安装完成后,使用bingo studio命令,但是没有界面被唤起。

**可能原因1:**您使用的 linux 环境并非 wsl

**处理建议:**非 wsl 环境需要手动输入地址打开。 在 windows 中的 web 浏览器中(edge、Internet Explorer、chrome 任意均可)输入图中所示位置的地址,即可打开 BMC Studio 前端页面。

**问题现象2:**日志无异常,有浏览器窗口被打开,但窗口白屏,一段时间后显示无连接。

**可能原因2:**您曾经在配置过 netsh 转发规则

**处理建议:**打开管理员权限的 powershell ,输入命令

bash
netsh interface portproxy show all

如果发现有您的端口号相关的设置,请清除它。

powershell
netsh interface portproxy delete v4tov4 listenport=10000 listenaddress=x.x.x.x

请自行替换命令中的listenaddresss

**问题现象3:**现象同问题现象2,但netsh interface portproxy show all没有发现回显

**可能原因3:**有进程在占用您的端口号 处理建议:

bash
# 在wsl终端里输入以下命令查找是否有进程在占用10000端口
sudo netstat -tlnp | grep :10000

# 如果发现占用进程,结束它
sudo kill -9 <PID>

请自行替换命令中的端口号和 pid 此外,windows 端中也有可能有进程占用 10000 端口。 您可以使用命令:

powershell
netstat -ano | findstr :10000

如果看到如下回显:

请在任务管理器中使用回显中最后的数字查找该进程,如果您认识且认为不重要,您可以在任务管理器中右键点击这个进程并点击"结束进程"

如果该应用对您很重要,可以修改我们的脚本,将/usr/share/bmc_studio/load_nginx.sh中的第46行从

bash
FRONTEND_PORT=$((10000 + USER_ID % 10000))

修改为

bash
FRONTEND_PORT=$((10001 + USER_ID % 10000))

**问题现象4:**日志报错"Failed to auto-open in WSL"

**可能原因4:**您在 /etc/wsl.conf 这个文件中配置了 default=root ,wslu 的 bug 会将这个配置误识别为 windows 挂载点配置,导致无法获取到正确的 windows 目录地址。

**处理建议:**打开文件 /usr/bin/wslview,删除114~119行内容:

bash
 if [ -f /etc/wsl.conf ]; then
  tmp="$(awk -F '=' '/root/ {print $2}' /etc/wsl.conf | awk '{$1=$1;print}')"
  [ "$tmp" == "" ] || win_location="$tmp"
  [[ "$win_location" =~ ^.*/$ ]] || win_location="$win_location/" # make sure it always end with slash
  unset tmp
 fi

删除完成后,重新打开 BMC Studio 。

Q4:BMC Studio 上传文件/文件夹报错 fail to post /studio-tool/csr/folder

问题现象: 在 csr 页面选择导入代码仓或导入单个 csr 报错,信息为

bash
fail to post /studio-tool/csr/folder

可能原因: 您的系统磁盘剩余空间不足

处理建议: 清理您的系统,获得更多的磁盘剩余空间。

Q5:BMC Studio 一键仓库部署超时

问题现象: 使用 manifest 创建完工作空间后,按照文档流程在仓库管理页面点击一键仓库部署,然而超时失败

可能原因: 您没有登陆 conan 账号

处理建议: 在命令行输入命令

bash
conan remote login openubmc_dev 您的账号 -p 您的密码

登录 conan 账号后,重新一键仓库部署即可。

Q6:BMC Studio 的 QEMU 在线调试过程中,资源协作接口获取不全

问题现象: 拉起 QEMU 后,使用 BMC Studio 连接上 QEMU ,点开在线调试的资源协作接口窗口后,接口显示很少。

可能原因: QEMU 性能较慢,获取全量接口需要时间。

处理建议: 请耐心等待,并通过刷新按钮查看新增接口。

Q7:BMC Studio 连接真机后,无法进行在线调试

问题现象: BMC Studio 连接真机后,无法进行在线调试。

可能原因: BMC Studio 的在线调试能力尚未支持真机,存在破坏环境的风险,目前暂时仅支持基于 QEMU 的调试。

处理建议: 建议使用 QEMU 进行替代。QEMU 每次启动都会重置,调试导致环境出现问题后只需要重启 QEMU 即可。

Q8:无法使用插件进行调试文件

问题现象: 使用 VsCode 修改文件后,无法进行调试或右上角没有调试图标

可能原因: 不是所有文件都支持调试,支持的文件主要是 /opt/bmc/apps/ 组件名路径下的 lua 文件、北向接口配置文件以及 /opt/bmc/sr 路径下的内置CSR文件。且 mdb_interface 这种模型定义仓暂时也不支持直接通过 VsCode 调试。

处理建议: 使用出整包的方式调试。

Q9:运行 BMC Studio 时闪退

问题现象: 运行 BMC Studio 时闪退,报错信息为

bash
xxxxxx E Thread "bmc_studio_serv" catched unhandled SIGILL /(Illegal instruction) from managed frame. signal pc: 0xxxxxxxxxxxxx
/usr/share/bmc_studio/bmc_studio.sh: line 96: xxxxxx Segmentation fault      ./bmc_studio_server "$1"
Failed to start foreground service

可能原因: BMC Studio 使用仓颉语言开发,目前仓颉语言依赖 avx2 指令集。您使用的电脑 CPU 可能不支持 avx2 指令集。可以通过在 linux 命令行中执行命令

bash
lscpu | grep avx2

来进行判断。如果没有出现结果,那么您的 cpu 可能就不支持 avx2 指令集。

解决方案: 如果您的 cpu 不支持 avx2 指令集,可能暂时无法使用 BMC Studio。请期待未来仓颉更新后解除对 avx2 指令集的依赖。

Q10:运行 BMC Studio 的终端被关闭了,如何查看日志?

问题现象: 在命令行唤起 BMC Studio 后,终端被误关闭,导致没法看日志。

解决方案: BMC Studio 的日志会保存在 ~/bmc_studio/var/log/debug.log 中,可以手动打开这个文件进行查看。