第02章:安装与环境配置

第02章:安装与环境配置

2.1 系统要求

2.1.1 硬件要求

FreeCAD对硬件的要求相对适中,但为了获得良好的使用体验,建议满足以下配置:

最低配置

  • CPU:双核1.5GHz以上
  • 内存:4GB RAM
  • 显卡:支持OpenGL 2.0的独立显卡或集成显卡
  • 硬盘空间:2GB可用空间
  • 显示器:1024×768分辨率

推荐配置

  • CPU:四核2.5GHz以上(Intel i5/i7或AMD Ryzen 5/7)
  • 内存:8GB RAM或更多
  • 显卡:支持OpenGL 3.3的独立显卡(NVIDIA/AMD),显存2GB以上
  • 硬盘空间:10GB以上SSD
  • 显示器:1920×1080或更高分辨率

高端配置(用于大型复杂项目)

  • CPU:八核3.0GHz以上
  • 内存:16GB-32GB RAM
  • 显卡:专业图形卡(NVIDIA Quadro/AMD FirePro)或高端游戏卡
  • 硬盘空间:50GB以上高速SSD
  • 显示器:双显示器,2K或4K分辨率

性能说明

  • CPU:多核对于某些操作(如网格生成)有明显加速
  • 内存:处理大型装配体时内存需求会显著增加
  • 显卡:OpenGL支持很重要,影响3D视图流畅度
  • 硬盘:SSD可以明显加快文件加载和保存速度

2.1.2 操作系统要求

FreeCAD支持主流的三大操作系统平台:

Windows

  • Windows 7 SP1(64位)或更高版本
  • Windows 8/8.1(64位)
  • Windows 10(64位,推荐)
  • Windows 11(64位)
  • 注意:不再支持32位Windows系统

Linux

  • Ubuntu 18.04 LTS或更高版本(推荐)
  • Debian 10或更高版本
  • Fedora 30或更高版本
  • openSUSE Leap 15.0或更高版本
  • Arch Linux(滚动发行)
  • 其他发行版:需要自行编译或使用AppImage

macOS

  • macOS 10.12 Sierra或更高版本
  • macOS 10.15 Catalina或更高版本(推荐)
  • macOS 11 Big Sur
  • macOS 12 Monterey
  • macOS 13 Ventura
  • 支持Intel和Apple Silicon(M1/M2)处理器

2.1.3 依赖软件

FreeCAD依赖一些第三方库和组件:

自动包含的依赖

  • Qt 5.x:图形用户界面框架
  • Python 3.x:脚本语言
  • OpenCASCADE:几何内核
  • Coin3D:3D图形库
  • PySide2:Python的Qt绑定

可选依赖

  • POV-Ray:高质量渲染
  • LuxRender:光线追踪渲染
  • Netgen:网格生成
  • CalculiX:有限元分析

说明:Windows和macOS的安装包通常已包含所有必要的依赖库,无需额外安装。Linux用户可能需要通过包管理器安装某些依赖。

2.2 Windows系统安装

2.2.1 下载安装包

官方下载

  1. 访问FreeCAD官网:https://www.freecad.org/
  2. 点击"Download"按钮
  3. 选择Windows版本(推荐下载最新稳定版)
  4. 有两种安装包可选:
    • Installer(安装程序):约300-400MB
    • Portable(便携版):无需安装,解压即用

下载镜像

版本选择

  • 稳定版(Stable):推荐日常使用,如0.20.2
  • 开发版(Dev):包含最新功能,但可能不稳定
  • 长期支持版(LTS):用于生产环境

2.2.2 安装步骤

使用安装程序

  1. 启动安装

    • 双击下载的.exe安装文件
    • 如果出现用户账户控制提示,点击"是"
  2. 选择语言

    • 安装程序会检测系统语言
    • 可以手动选择中文
  3. 许可协议

    • 阅读LGPL许可证
    • 勾选"我接受协议"
    • 点击"下一步"
  4. 选择安装位置

    • 默认路径:C:\Program Files\FreeCAD 0.20
    • 可以自定义安装路径
    • 确保有足够的磁盘空间
    • 建议安装在SSD上以提高性能
  5. 选择组件

    • 核心文件(必选)
    • 工作台(建议全选)
    • 插件管理器(推荐)
    • 文档和示例(可选)
  6. 创建快捷方式

    • 桌面快捷方式
    • 开始菜单文件夹
    • 快速启动栏图标
  7. 开始安装

    • 点击"安装"按钮
    • 等待文件复制完成(约3-5分钟)
  8. 完成安装

    • 勾选"运行FreeCAD"
    • 点击"完成"

使用便携版

  1. 下载Portable版本的ZIP文件
  2. 解压到任意目录(如D:\FreeCAD-Portable)
  3. 打开解压目录,双击FreeCAD.exe即可运行
  4. 便携版的优势:
    • 无需安装,可以放在U盘中
    • 不写入注册表
    • 方便在多台电脑间使用
    • 卸载只需删除文件夹

2.2.3 安装后配置

首次启动

  1. 启动FreeCAD
  2. 选择界面语言(如果默认不是中文)
  3. 接受工作空间布局设置

环境变量配置(可选)

  • 如需在命令行调用FreeCAD,添加到系统PATH
  • 路径:C:\Program Files\FreeCAD 0.20\bin

文件关联

  • 右键.FCStd文件 → 打开方式 → 选择FreeCAD
  • 设置为默认程序

创建工作目录

  • 建议创建专门的项目文件夹
  • 例如:D:\FreeCAD-Projects
  • 便于管理和备份

2.2.4 常见问题解决

问题1:启动时提示缺少DLL文件

  • 原因:系统缺少Visual C++运行库
  • 解决:安装Microsoft Visual C++ Redistributable 2015-2022

问题2:3D视图显示异常或空白

  • 原因:显卡驱动过旧或不支持OpenGL
  • 解决:更新显卡驱动到最新版本

问题3:软件启动缓慢

  • 原因:杀毒软件扫描或硬盘速度慢
  • 解决:
    • 将FreeCAD添加到杀毒软件白名单
    • 安装到SSD
    • 关闭不必要的启动项

问题4:中文界面显示乱码

  • 原因:系统字体或编码问题
  • 解决:
    • 工具 → 自定义 → 界面语言 → 重新选择中文
    • 检查系统区域设置

2.3 Linux系统安装

2.3.1 使用包管理器安装

Linux上安装FreeCAD最简单的方式是使用系统的包管理器。

Ubuntu/Debian系统

# 更新软件源
sudo apt update

# 安装FreeCAD(官方仓库版本,可能较旧)
sudo apt install freecad

# 安装FreeCAD的Python绑定(用于脚本开发)
sudo apt install freecad-python3

# 安装附加模块和文档
sudo apt install freecad-doc freecad-examples

使用PPA获取最新版本

# 添加FreeCAD稳定版PPA
sudo add-apt-repository ppa:freecad-maintainers/freecad-stable
sudo apt update
sudo apt install freecad

# 或者安装每日构建版(开发版)
sudo add-apt-repository ppa:freecad-maintainers/freecad-daily
sudo apt update
sudo apt install freecad-daily

Fedora系统

# 安装FreeCAD
sudo dnf install freecad

# 安装开发版
sudo dnf install freecad --enablerepo=updates-testing

openSUSE系统

# 安装FreeCAD
sudo zypper install FreeCAD

# 或通过OBS获取最新版本
sudo zypper ar -f obs://home:FreeCAD FreeCAD
sudo zypper ref
sudo zypper install FreeCAD

Arch Linux

# 安装FreeCAD
sudo pacman -S freecad

# 从AUR安装开发版
yay -S freecad-git

2.3.2 使用AppImage

AppImage是一种通用的Linux应用程序格式,不依赖特定发行版。

下载和使用

# 下载AppImage文件(从FreeCAD官网或GitHub)
wget https://github.com/FreeCAD/FreeCAD/releases/download/0.20.2/FreeCAD_0.20.2-Linux-x86_64.AppImage

# 添加执行权限
chmod +x FreeCAD_0.20.2-Linux-x86_64.AppImage

# 运行FreeCAD
./FreeCAD_0.20.2-Linux-x86_64.AppImage

创建桌面快捷方式

# 创建.desktop文件
cat > ~/.local/share/applications/freecad.desktop << EOF
[Desktop Entry]
Name=FreeCAD
Comment=Feature based parametric modeler
Exec=/path/to/FreeCAD.AppImage
Icon=/path/to/freecad-icon.png
Terminal=false
Type=Application
Categories=Graphics;Science;Engineering;
EOF

# 更新桌面数据库
update-desktop-database ~/.local/share/applications

AppImage的优势

  • 不需要root权限
  • 不污染系统环境
  • 可以同时运行多个版本
  • 方便在不同Linux发行版间使用

2.3.3 从源代码编译

对于需要最新功能或自定义编译选项的用户,可以从源代码编译。

安装编译依赖(Ubuntu/Debian)

# 安装构建工具
sudo apt install build-essential cmake python3 python3-dev

# 安装Qt依赖
sudo apt install qtbase5-dev qttools5-dev qtwebengine5-dev libqt5svg5-dev libqt5xmlpatterns5-dev libqt5opengl5-dev

# 安装OpenCASCADE
sudo apt install libocct-*-dev occt-misc

# 安装其他依赖
sudo apt install libcoin-dev libsoqt-dev libxerces-c-dev \
    libeigen3-dev libqt5webkit5-dev libshiboken2-dev \
    libpyside2-dev pyside2-tools python3-pyside2.qtcore \
    python3-pyside2.qtgui python3-pyside2.qtsvg \
    python3-pyside2.qtwidgets python3-pyside2.qtnetwork

# 安装可选依赖
sudo apt install libvtk9-dev python3-matplotlib libmed-dev \
    libzipios++-dev libboost-all-dev libfreeimage-dev \
    doxygen libspnav-dev oce-draw

下载源代码

# 克隆Git仓库
git clone https://github.com/FreeCAD/FreeCAD.git
cd FreeCAD

# 检出特定版本(可选)
git checkout 0.20.2

# 或使用最新开发版
git checkout master

编译安装

# 创建构建目录
mkdir build
cd build

# 配置CMake
cmake ../freecad \
    -DCMAKE_BUILD_TYPE=Release \
    -DCMAKE_INSTALL_PREFIX=/usr/local/FreeCAD \
    -DBUILD_QT5=ON \
    -DPYTHON_EXECUTABLE=/usr/bin/python3

# 编译(使用所有CPU核心)
make -j$(nproc)

# 安装
sudo make install

编译选项说明

  • CMAKE_BUILD_TYPE:Release(发布版)或Debug(调试版)
  • CMAKE_INSTALL_PREFIX:安装路径
  • BUILD_QT5:使用Qt5(推荐)
  • FREECAD_USE_EXTERNAL_PIVY:使用系统的Pivy库

2.3.4 配置和优化

配置OpenGL

对于某些显卡,可能需要配置OpenGL设置:

# 编辑FreeCAD配置文件
nano ~/.config/FreeCAD/FreeCAD.conf

# 添加或修改以下行
[Preferences]
UseOpenGL2Backend=true

配置Python环境

# 确保系统Python路径正确
export PYTHONPATH=/usr/lib/python3/dist-packages:$PYTHONPATH

# 添加到~/.bashrc以持久化
echo 'export PYTHONPATH=/usr/lib/python3/dist-packages:$PYTHONPATH' >> ~/.bashrc

性能优化

# 使用硬件加速
export LIBGL_DRI3_DISABLE=1  # 某些显卡可能需要

# 增加OpenGL缓冲
export MESA_GL_VERSION_OVERRIDE=3.3

# 对于NVIDIA显卡
export __GL_SHADER_DISK_CACHE_PATH=/tmp/__GL_SHADER_DISK_CACHE/

2.4 macOS系统安装

2.4.1 下载和安装

下载安装包

  1. 访问FreeCAD官网下载页面
  2. 选择macOS版本
  3. 下载.dmg安装镜像文件

Intel处理器Mac

  • 下载标准版本:FreeCAD-0.20.2-macOS-Intel-x86_64.dmg

Apple Silicon(M1/M2)Mac

  • 下载ARM版本:FreeCAD-0.20.2-macOS-ARM64.dmg
  • 或使用Intel版本通过Rosetta 2运行

安装步骤

  1. 打开DMG文件

    • 双击下载的.dmg文件
    • 等待镜像挂载
  2. 安装应用

    • 将FreeCAD图标拖动到Applications文件夹
    • 等待文件复制完成
  3. 首次启动

    • 打开Applications文件夹
    • 双击FreeCAD图标
    • 如果出现"无法打开,因为它来自身份不明的开发者":
      • 按住Control键点击FreeCAD图标
      • 选择"打开"
      • 在弹出的对话框中点击"打开"
  4. 授予权限

    • 系统可能要求授予某些权限
    • 根据提示授予必要的权限

2.4.2 使用Homebrew安装

Homebrew是macOS上流行的包管理器,可以更方便地安装和更新FreeCAD。

安装Homebrew(如果尚未安装)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

通过Homebrew安装FreeCAD

# 安装FreeCAD
brew install --cask freecad

# 更新FreeCAD
brew upgrade --cask freecad

# 卸载FreeCAD
brew uninstall --cask freecad

优势

  • 自动处理依赖关系
  • 便于版本管理和更新
  • 与其他开发工具集成良好

2.4.3 配置和故障排除

配置Python环境

macOS版FreeCAD内置Python环境,一般无需额外配置。如需使用系统Python或虚拟环境:

# 查看FreeCAD使用的Python路径
/Applications/FreeCAD.app/Contents/MacOS/FreeCAD --version

# 设置PYTHONPATH(如需要)
export PYTHONPATH=/usr/local/lib/python3.9/site-packages:$PYTHONPATH

解决启动问题

问题1:应用无法打开

# 移除隔离属性
sudo xattr -rd com.apple.quarantine /Applications/FreeCAD.app

问题2:3D视图显示异常

  • 更新macOS到最新版本
  • 更新显卡驱动(自动更新)
  • 在FreeCAD中调整OpenGL设置

问题3:性能问题

  • 关闭不必要的视觉效果
  • 增加分配给FreeCAD的内存
  • 使用Apple Silicon原生版本(M1/M2 Mac)

创建命令行别名

# 编辑~/.zshrc或~/.bash_profile
nano ~/.zshrc

# 添加别名
alias freecad='/Applications/FreeCAD.app/Contents/MacOS/FreeCAD'

# 重新加载配置
source ~/.zshrc

# 现在可以在终端中使用freecad命令
freecad myfile.FCStd

2.5 基本配置

2.5.1 界面语言设置

更改界面语言

  1. 启动FreeCAD
  2. 菜单:编辑 → 首选项
  3. 左侧选择"通用"
  4. 在"语言"下拉框中选择"中文(简体)"
  5. 点击"应用"
  6. 重启FreeCAD生效

语言文件位置

  • Windows:C:\Program Files\FreeCAD\translations\
  • Linux:/usr/share/freecad/translations/
  • macOS:/Applications/FreeCAD.app/Contents/Resources/translations/

2.5.2 首选项配置

FreeCAD的首选项包含了大量的设置选项,以下是重要的配置项。

通用设置

访问路径:编辑 → 首选项 → 通用

  • 语言:界面显示语言
  • 单位制:公制/英制(建议使用公制)
  • 小数位数:数值显示精度(默认2位)
  • 启动操作:启动时的默认行为
    • 显示启动页
    • 打开最近文档
    • 新建空白文档
  • 文档恢复:自动保存间隔(建议5-10分钟)
  • 主题:界面配色方案
    • 深色
    • 浅色
    • 经典

显示设置

访问路径:编辑 → 首选项 → 显示

  • 3D视图

    • 反锯齿:开启以获得更平滑的显示
    • 透明度:对象透明度支持
    • 背景颜色:视图背景色
    • 渐变背景:使用渐变色背景
  • 导航

    • 导航方式:
      • CAD:类似商业CAD软件
      • 转盘:默认方式
      • OpenInventor
      • Blender:类似Blender软件
    • 旋转模式:围绕点旋转或自由旋转
    • 反转缩放:滚轮方向
  • 网格和坐标系

    • 显示网格:是否显示地面网格
    • 网格大小:网格间距
    • 显示坐标轴:XYZ轴指示器

编辑器设置

访问路径:编辑 → 首选项 → 编辑器

  • 宏编辑器

    • 字体:等宽字体,如Consolas、Monaco
    • 字体大小:10-12pt
    • 语法高亮:开启
    • 制表符宽度:4个空格
    • 自动缩进:开启
  • 代码补全

    • 启用自动补全
    • 补全延迟时间

2.5.3 工作台配置

配置工作台

访问路径:编辑 → 首选项 → 工作台

  • 启用的工作台:勾选常用的工作台

    • Part(零件)
    • Part Design(零件设计)
    • Sketcher(草图)
    • Draft(绘图)
    • Arch(建筑)
    • Path(路径/数控)
  • 工作台顺序:调整工作台在菜单中的显示顺序

  • 默认工作台:启动时默认激活的工作台

自动加载工作台

某些工作台会在特定操作时自动切换:

  • 创建新草图时自动切换到Sketcher工作台
  • 编辑PartDesign特征时自动切换到PartDesign工作台

可以在首选项中禁用此行为。

2.5.4 性能优化配置

渲染优化

访问路径:编辑 → 首选项 → 显示 → 3D视图

  • 渲染缓存:启用可提高复杂模型的显示性能
  • 使用VBO:使用顶点缓冲对象,提高渲染速度
  • 帧率限制:限制最大帧率以降低功耗

内存管理

访问路径:编辑 → 首选项 → 通用 → 文档

  • 文档对象缓存:增加缓存大小可提高性能但占用更多内存
  • 压缩文件:保存时压缩以节省磁盘空间(稍微影响保存速度)

撤销/重做设置

访问路径:编辑 → 首选项 → 通用 → 文档

  • 撤销/重做级别
    • 较少的级别(10-20):节省内存,适合大型项目
    • 较多的级别(50-100):方便操作,适合小型项目

2.6 插件管理

2.6.1 插件管理器

FreeCAD内置插件管理器,可以方便地安装和管理扩展。

打开插件管理器

方法1:菜单 → 工具 → 插件管理器
方法2:启动页面 → 插件管理器图标

插件管理器界面

  • 工作台:可安装的工作台扩展
  • :预制的宏脚本
  • 首选项包:配置文件集合

安装插件

  1. 在插件列表中浏览可用插件
  2. 点击要安装的插件
  3. 查看插件描述和截图
  4. 点击"安装"按钮
  5. 等待下载和安装完成
  6. 重启FreeCAD以加载新插件

2.6.2 常用插件推荐

Fasteners(紧固件库)

  • 功能:提供各种标准紧固件(螺栓、螺母、垫圈等)
  • 用途:机械装配设计
  • 安装:插件管理器中搜索"Fasteners"

A2plus(装配工作台)

  • 功能:组件装配和约束管理
  • 用途:创建复杂装配体
  • 安装:插件管理器中搜索"A2plus"

SheetMetal(钣金工作台)

  • 功能:钣金件设计和展开
  • 用途:钣金零件设计
  • 安装:插件管理器中搜索"SheetMetal"

Curves(曲线工具)

  • 功能:高级曲线曲面建模工具
  • 用途:复杂曲面设计
  • 安装:插件管理器中搜索"Curves"

Lattice2(阵列工具)

  • 功能:高级阵列和参数化布置
  • 用途:复杂阵列设计
  • 安装:插件管理器中搜索"Lattice2"

Animation(动画工作台)

  • 功能:创建机构运动动画
  • 用途:机构仿真和展示
  • 安装:插件管理器中搜索"Animation"

2.6.3 手动安装插件

某些插件可能不在官方插件库中,需要手动安装。

查找宏目录

  1. 打开FreeCAD
  2. 菜单:宏 → 宏...
  3. 点击"用户宏位置"按钮
  4. 记下显示的路径

常见宏目录位置

  • Windows:C:\Users\<用户名>\AppData\Roaming\FreeCAD\Macro\
  • Linux:~/.local/share/FreeCAD/Macro/
  • macOS:~/Library/Application Support/FreeCAD/Macro/

手动安装步骤

  1. 从GitHub或论坛下载插件文件(通常是.py或.FCMacro文件)
  2. 将文件复制到宏目录
  3. 重启FreeCAD
  4. 在宏菜单中可以看到新安装的宏

安装工作台

对于完整的工作台插件:

  1. 找到FreeCAD的Mod目录:

    • Windows:C:\Program Files\FreeCAD\Mod\
    • Linux:~/.local/share/FreeCAD/Mod//usr/share/freecad/Mod/
    • macOS:~/Library/Application Support/FreeCAD/Mod/
  2. 将工作台文件夹复制到Mod目录

  3. 重启FreeCAD

  4. 在工作台下拉列表中选择新工作台

2.7 文件管理

2.7.1 项目组织

创建项目结构

建议为FreeCAD项目创建有组织的文件夹结构:

MyProject/
├── Designs/          # 设计文件
│   ├── Part1.FCStd
│   ├── Part2.FCStd
│   └── Assembly.FCStd
├── Drawings/         # 工程图
│   ├── Part1_Drawing.pdf
│   └── Part2_Drawing.pdf
├── Exports/          # 导出文件
│   ├── STL/
│   ├── STEP/
│   └── DXF/
├── References/       # 参考文件
│   └── Specifications.pdf
├── Macros/          # 项目特定的宏
│   └── custom_macro.FCMacro
└── README.md        # 项目说明

文件命名规范

  • 使用有意义的名称:Gear_Module2_Z20.FCStd 而不是 part1.FCStd
  • 使用版本号:Housing_v1.0.FCStd, Housing_v1.1.FCStd
  • 避免使用空格和特殊字符
  • 使用驼峰命名或下划线分隔

2.7.2 备份策略

自动备份

FreeCAD提供自动备份功能:

  1. 编辑 → 首选项 → 通用 → 文档
  2. 启用"创建备份文件"
  3. 设置自动保存间隔(建议5-10分钟)
  4. 备份文件扩展名:.FCStd1, .FCStd2

手动备份

建立定期备份习惯:

  • 每天结束工作时备份
  • 重大修改前备份
  • 使用云存储服务(Dropbox、OneDrive、坚果云等)

版本控制

对于团队项目或重要项目,考虑使用Git进行版本控制:

# 初始化Git仓库
cd MyProject
git init

# 创建.gitignore文件
cat > .gitignore << EOF
*.FCStd1
*.FCStd2
*~
*.autosave
EOF

# 提交初始版本
git add .
git commit -m "Initial commit"

# 创建新版本
git add .
git commit -m "Added gear model"

2.7.3 文件格式

FreeCAD原生格式

  • .FCStd:标准FreeCAD文档格式(实际是ZIP压缩包)
  • .FCStd1, .FCStd2:自动备份文件

导入格式

  • .step, .stp:STEP格式(推荐用于CAD数据交换)
  • .iges, .igs:IGES格式
  • .stl:STL网格格式(3D打印)
  • .obj:Wavefront OBJ格式
  • .dxf:AutoCAD DXF格式(2D)
  • .svg:可缩放矢量图形
  • .ifc:建筑信息模型格式

导出格式

  • 除上述导入格式外,还支持:
  • .pdf:PDF格式(工程图)
  • .png, .jpg:图像格式
  • .wrl, .vrml:虚拟现实建模语言
  • .dae:Collada格式

2.8 环境变量

2.8.1 常用环境变量

FreeCAD支持多个环境变量来控制其行为:

FREECAD_USER_HOME

  • 作用:指定用户配置目录
  • 示例:export FREECAD_USER_HOME=~/MyFreeCADConfig

FREECAD_USER_DATA

  • 作用:指定用户数据目录(宏、插件等)
  • 示例:export FREECAD_USER_DATA=~/MyFreeCADData

PYTHONPATH

  • 作用:Python模块搜索路径
  • 示例:export PYTHONPATH=/usr/local/lib/python3.9/site-packages:$PYTHONPATH

QT_SCALE_FACTOR

  • 作用:调整界面缩放(用于高DPI显示器)
  • 示例:export QT_SCALE_FACTOR=1.5

2.8.2 配置环境变量

Windows

# 临时设置(当前会话)
set FREECAD_USER_HOME=D:\FreeCADConfig

# 永久设置(系统属性)
1. 右键"此电脑" → 属性
2. 高级系统设置
3. 环境变量
4. 新建用户变量
5. 变量名:FREECAD_USER_HOME
6. 变量值:D:\FreeCADConfig

Linux/macOS

# 临时设置(当前会话)
export FREECAD_USER_HOME=~/MyFreeCADConfig

# 永久设置(添加到~/.bashrc或~/.zshrc)
echo 'export FREECAD_USER_HOME=~/MyFreeCADConfig' >> ~/.bashrc
source ~/.bashrc

2.9 疑难问题排查

2.9.1 日志文件

FreeCAD会生成日志文件,帮助诊断问题。

日志文件位置

  • Windows:%APPDATA%\FreeCAD\
  • Linux:~/.local/share/FreeCAD/
  • macOS:~/Library/Application Support/FreeCAD/

日志文件

  • FreeCAD.log:主日志文件
  • FreeCAD_crash.log:崩溃日志

查看日志

在FreeCAD中:

  1. 视图 → 面板 → 报告视图
  2. 查看实时消息和警告

2.9.2 诊断模式

启用调试输出

# Windows
FreeCAD.exe --log-file=debug.log --verbose

# Linux/macOS
freecad --log-file=debug.log --verbose

命令行选项

  • --verbose:详细输出
  • --log-file=<path>:指定日志文件
  • --console:显示Python控制台
  • --no-splash:不显示启动画面

2.9.3 重置配置

如果FreeCAD行为异常,可以尝试重置配置:

备份当前配置

首先备份现有配置文件,以防需要恢复。

删除配置文件

  • Windows:删除%APPDATA%\FreeCAD\目录
  • Linux:删除~/.config/FreeCAD/目录
  • macOS:删除~/Library/Preferences/FreeCAD/目录

重启FreeCAD后将使用默认配置。

选择性重置

只重置特定设置:

  1. 编辑 → 首选项
  2. 找到相关设置
  3. 点击"重置为默认值"按钮

2.10 本章小结

本章详细介绍了FreeCAD在各主流平台上的安装和配置:

  • 了解了系统要求和硬件推荐配置
  • 掌握了在Windows、Linux、macOS上的安装方法
  • 学会了基本配置和首选项设置
  • 了解了插件管理和常用插件
  • 学习了文件管理和备份策略
  • 掌握了环境变量配置和问题排查方法

通过本章的学习,你应该已经成功安装并配置好了FreeCAD开发环境,为后续的学习和使用做好了准备。

在下一章中,我们将详细介绍FreeCAD的用户界面,帮助你熟悉各个界面元素和操作方式。

2.11 实践练习

  1. 安装验证

    • 启动FreeCAD
    • 创建一个简单的立方体(Part工作台 → 创建立方体)
    • 保存文件
    • 重新打开文件
  2. 配置练习

    • 更改界面语言为中文
    • 调整3D视图背景色
    • 修改导航方式为CAD模式
    • 设置自动保存间隔为10分钟
  3. 插件安装

    • 打开插件管理器
    • 安装Fasteners插件
    • 重启FreeCAD
    • 在Part工作台中查看Fasteners菜单
  4. 项目组织

    • 创建项目文件夹结构
    • 按照建议的目录结构组织文件
    • 创建一个测试项目并保存

2.12 扩展阅读


posted @ 2026-01-10 13:12  我才是银古  阅读(40)  评论(0)    收藏  举报