FreeCAD 启动后小窗口闪现即退的解决思路
FreeCAD 启动后小窗口闪现即退,核心原因是显卡 OpenGL 驱动兼容失败或配置文件损坏;优先尝试强制软件渲染启动并重置配置目录。
核心解决方案(按顺序尝试)
- 强制软件渲染启动(最常用有效)
- Windows:右键快捷方式→属性→“目标”栏末尾加空格输入
--disable-gpu,或直接运行命令行freecad.exe --disable-gpu;若仍失败,编辑%APPDATA%\FreeCAD\FreeCAD.cfg添加[OpenGL] UseSoftwareOpenGL=1。 - Linux:终端执行
LIBGL_ALWAYS_SOFTWARE=1 QT_QPA_PLATFORM=xcb freecad创建脚本启动。
- Windows:右键快捷方式→属性→“目标”栏末尾加空格输入
- 重置损坏的用户配置
- 关闭 FreeCAD,重命名或删除配置文件夹:Windows 为
%APPDATA%\FreeCAD,Linux/macOS 为~/.FreeCAD(先备份),重启软件让系统重建默认配置。
- 关闭 FreeCAD,重命名或删除配置文件夹:Windows 为
- 检查依赖与路径
- 确保安装路径无中文字符或特殊符号;若是便携版,务必用 7-Zip 完整解压(WinRAR 易导致文件损坏);确认显卡驱动已更新至稳定版,老旧显卡(如 GT 710 及更早)必须使用软件渲染模式。
排查步骤与日志定位
若上述无效,需通过日志确认具体报错:
- 以调试模式启动:命令行执行
freecad --log-level=DEBUG,观察控制台最后输出的错误信息(如ImportError、OpenGL initialization failed)。 - 查看日志文件:启动失败后检查
%APPDATA%\FreeCAD\log.txt(Windows) 或~/.FreeCAD/log.txt(Linux) 中的崩溃堆栈。 - 常见特定场景:
- 双显卡笔记本:在 NVIDIA/AMD 控制面板中强制 FreeCAD 使用高性能独立显卡,而非核显。
- Linux Wayland 环境:强制切换至 X11 后端(见上述 Linux 启动命令)。
- 依赖缺失:Linux 下需安装
coinor-libcoin、python3-pivy等库;Windows 官方安装包通常自带,勿随意修改系统 Python 环境。
注意事项
- 区分软件:FreeCAD 是开源免费软件,不需要激活服务(FlexNet),请勿参考 AutoCAD 的“开启许可服务”方案,那是无效操作。
- 版本选择:若当前版本持续崩溃,可尝试下载官方 Portable(便携版) 解压使用,或回退至 FreeCAD 0.21 等成熟旧版测试是否为新版 Bug。
