【踩坑记录】Linux环境下FreeCAD打开后一新建就崩

Linux版本：24.04

FreeCAD：0.21.1
故障现象：

FreeCAD打开后一新建就崩

解决方法：

创建一个一键启动脚本，作为程序就打开不崩的 FreeCAD：

第一步，桌面右键 → 新建文档 → 命名为 freecad_start.sh（后缀必须是 .sh）；

第二步，打开文件，粘贴以下内容并保存*

#!/bin/bash
LIBGL_ALWAYS_SOFTWARE=1 QT_QPA_PLATFORM=xcb freecad

为什么这个命令对 0.21.1 有效？ FreeCAD 0.21.1 在 Linux 下的崩溃，95% 是：

Wayland 桌面兼容问题：QT_QPA_PLATFORM=xcb 强制用 X11 渲染；

显卡 OpenGL 兼容问题：LIBGL_ALWAYS_SOFTWARE=1 强制软件渲染，避开独显驱动 bug；

这两个参数是 0.21.1 版本测试过的 "稳如狗" 组合。

第三步，将文件设置为允许作为程序执行文件，右键这个文件 → 属性 → 权限 → 勾选 "允许作为程序执行文件"（勾上后图标会变）；

右键点击文件，选择"作为程序运行"，直接启动 FreeCAD 0.21.1，再也不会新建崩溃。

效果：

成功新建并导入step文件

总结

核心修复逻辑：强制软件渲染 + X11 渲染，避开 0.21.1 在 Linux 下的显卡 / 桌面兼容坑；

制作 .sh 脚本可实现一键启动，不用每次输长命令。

说明：以上部分内容参考豆包，解决方法亲测可用。