星闪开发入门之常见报错整理（一）

计蒙不吃鱼

发布于 2025-06-12 19:52:27

18400

代码可运行

文章被收录于专栏：星闪相关星闪相关

运行总次数：0

代码可运行

前言

最近加了很多玩星闪板子的小伙伴，交流的过程中出现了很多重复的问题，以下将常见的问题进行整理，为各位玩星闪板子的开发者提供便利。

一、ComX open fail, please check com is busy or not exist

X端口不存在或被占用

Com3 open fail, please check com is busy or not exist

解决方法：需要在工程配置中重新选择端口。

二、‌CMake下载失败

===== [cmake下载失败，请下载对应的whl文件至任意目录，在该目录下打开命令提示符（cmd）执行“pip install cmake-3.20.5-py2.py3-none-win_amd64.whl”即可，
下载链接：https://files.pythonhosted.org/packages/65/7f/80cf681cd376834b442af8af48e6f17b4197d20b7255aa2f76d8d93a9e44/cmake-3.20.5-py2.py3-none-win_amd64.whl] ======
===== [pycparser下载失败，请下载对应的whl文件至任意目录，在该目录下打开命令提示符（cmd）执行“pip install pycparser-2.21-py2.py3-none-any.whl”即可，
下载链接：https://files.pythonhosted.org/packages/62/d5/5f610ebe421e85889f2e55e33b7f9a6795bd982198517d912eb1c76e1a53/pycparser-2.21-py2.py3-none-any.whl] ======
===== [kconfiglib下载失败，请下载对应的whl文件至任意目录，在该目录下打开命令提示符（cmd）执行“pip install kconfiglib-14.1.0-py2.py3-none-any.whl”即可，
下载链接：https://files.pythonhosted.org/packages/8a/f1/d98a89231e779b079b977590efcc31249d959c8f1d4b5858cad69695ff9c/kconfiglib-14.1.0-py2.py3-none-any.whl] ======
===== [windowscurses下载失败，请下载对应的whl文件至任意目录，在该目录下打开命令提示符（cmd）执行“pip install windows_curses-2.3.3-cp311-cp311-win_amd64.whl”即可，
下载链接：https://files.pythonhosted.org/packages/18/1b/e06eb41dad1c74f0d3124218084f258f73a5e76c67112da0ba174162670f/windows_curses-2.3.3-cp311-cp311-win_amd64.whl] ======
======== [Python环境中的pip install异常,若添加后仍编译失败请关闭请关闭所有HiSpark Studio再打开重新执行编译] ======

解决方法：星闪开发入门级教程之安装编译器与小项目烧录------见文章一.3

三、配置文件出现语法错误

项目的配置文件CMakeLists.txt等可能存在错误，导致编译或链接失败。

Executing task: python  \"e:\HiSparkStudio\HiSpark Studio\resources\app\extensions\huawei.cfbb-kconfig-0.0.1\configHandler\show_config.py\" \"./config.in ws63 acore ws63-liteos-app ./build/config/target_config/ws63/menuconfig/acore\" \"guiconfig\" 

Traceback (most recent call last):
  File "e:\HiSparkStudio\HiSpark Studio\resources\app\extensions\huawei.cfbb-kconfig-0.0.1\configHandler\show_config.py", line 64, in <module>
show_kconfig(kconfig_path, show_kconfig_args, show_konfig_choice, None)
  File "e:\HiSparkStudio\HiSpark Studio\resources\app\extensions\huawei.cfbb-kconfig-0.0.1\configHandler\show_config.py", line 38, in show_kconfig
  kconf = Kconfig(filename=kconfig)
            ^^^^^^^^^^^^^^^^^^^^^^^^^

解决方法：检查配置文件中是否有错误

四、路径过长导致编译报错

将源文件路径缩短，建议将路径放在本地盘下面。

五、ninja: build stopped: subcommand failed

一般出现在编译过程中。 检查命令路径：所涉及路径是否正确，在命令行中执行出错的命令，是否能够执行成功配置ninja：通过Python的pip包管理工具重新安装或更新ninja。 命令行中执行

pip3 install ninja

并重新编译项目

六、OLED文字显示乱码

这款OLED（ws63）得使用阴码，逐行式，顺向生成字模。解决方法：星闪开发入门之一篇文章带你玩转OLED灯

七、python兼容相关

ModuleNotFoundError: No module named ‘distutils‘

Traceback (most recent call last):
  File "d:\fbb_ws63-master\src\build.py", line 38, in <module>
    from distutils.spawn import find_executable
ModuleNotFoundError: No module named 'distutils'

解决办法：切换或者安装一个低版本的distutils组件。

具体链接：解决ModuleNotFoundError: No module named ‘distutils‘

八 SLE连接错误码

八、其他非具体问题

内存泄漏，符号未定义，编译参数错误，缺少依赖库，编译参数错误，库文件找不到，空指针引用，数组越界，资源竞争或死锁等。

工具链安装不完整或配置不正确可能导致编译失败
使用代码编辑器或IDE的语法高亮和错误提示功能，以及调试工具来定位并修复这些问题。
仔细审查代码逻辑，确保所有条件、循环、函数调用等都正确无误
硬件连接不正确或不稳定，以及硬件故障可能导致通信失败或数据错误
清理不必要的文件或移动数据到其他磁盘上，以释放足够的空间
有的时候要注意产品更新后引脚配置是否修改，避免做无用功。
......