【亲测免费】 CadQuery编辑器(CQ-editor)教程

1. 项目介绍

CadQuery编辑器（CQ-editor）是基于PyQT构建的一款开源CAD图形界面工具，专为CadQuery库设计。该编辑器支持Linux、Windows和Mac操作系统，提供以下显著特性：

• 自动代码重新加载：在开发过程中，你可以使用你喜欢的代码编辑器，代码更改会实时反映到CQ-editor中。
• 基于OCCT的3D建模：利用Open CASCADE Technology (OCCT)的强大功能进行三维建模。
• 可视化日志查看：通过Log viewer面板跟踪和调试CadQuery脚本。

2. 项目快速启动

2.1 安装

macOS (Big Sur)

首先确保环境变量设置正确。然后，从项目根目录运行安装脚本：

./run.sh

Linux 和 macOS 其他版本

同样地，下载最新构建文件后，在其根目录下运行：

sh run.sh

Windows

对于Windows用户，执行.bat文件：

run.bat

2.2 首次启动

安装完成后，CQ-editor窗口应自动打开。如果遇到问题，特别是在macOS上，可能需要额外处理权限问题。例如，你可以使用命令：

xattr -r -d com.apple.quarantine path/to/CQ-editor-MacOS

2.3 使用conda或mamba

你也可以通过conda或mamba来安装：

mamba install -c cadquery -c conda-forge cq-editor=master

随后输入cq-editor以启动程序。

3. 应用案例与最佳实践

• 利用自动代码重载，可以快捷地测试和迭代你的设计。
• 在检查几何体干涉或间隙时，设置部件的透明度可以帮助可视化。
• 使用内置的日志记录功能 (log()) 而不是Python的 print() 函数，可以在GUI的日志面板中查看调试信息。
• 搭配外部文本编辑器，如VS Code或Sublime Text，提高代码编写效率。

4. 典型生态项目

CadQuery编辑器可与其他开源项目协同工作，如：

• CadQuery：基础3D建模库，用于编写脚本实现CAD操作。
• FreeCAD：一个参数化建模的开源CAD软件，可以与CadQuery结合使用。
• OCP：Open CASCADE Technology，提供底层3D建模技术。

了解这些项目及其生态系统，将有助于最大化CQ-editor的潜力和灵活性。