PythonOCC-Core 库的入门指南，涵盖环境配置（Conda）、核心功能验证及常见 GUI 可视化方案对比。内容包括安装步骤、代码示例及性能优化建议，帮助开发者快速搭建 3D 建模开发环境。
PythonOCC-Core 是一个基于 Python 的 OpenCASCADE (OCCT) 几何内核库，提供了三维几何形状的创建、分析和渲染等功能。适合对 3D 建模、CAD、CAE 以及 Python 有兴趣的开发者。
PythonOCC-Core 是一款基于 OpenCascade Technology（OCCT）内核的 Python 3D 建模库。简单来说，它就像一把'数字雕刻工具'，让开发者能通过 Python 代码轻松创建、修改和分析三维几何模型。无论是机械设计、建筑 BIM 还是科研仿真，这个工具都能提供专业级的几何操作能力。
| 软件/框架 | 最低版本 | 推荐版本 |
|---|---|---|
| Python | 3.9 | 3.10 |
| Conda | 4.8 | 23.11+ |
| PyQt | 5.12 | 6.4 |
| PySide | 2.0 | 6.4 |
注意：为什么推荐 Conda 环境？因为它能自动处理复杂的依赖关系，就像给 Python 安装了'应用工具箱'，一键搞定各种专业库
在开始安装前，请确保你的电脑已经准备好这些工具：
打开终端（Windows 用户建议用 Anaconda Prompt），依次执行以下命令：
# 1. 创建名为 pyocc 的专用环境
conda create --name pyocc python=3.10 -y
# 2. 激活这个新环境（重要！每次使用前都要执行）
conda activate pyocc
# 3. 添加 conda-forge 软件源（提供预编译的科学计算包）
conda config --add channels conda-forge
# 4. 设置通道优先级（避免依赖冲突）
conda config --set channel_priority strict
# 5. 验证环境是否创建成功
conda env list
在激活的 pyocc 环境中，执行这条命令：
conda install -c conda-forge pythonocc-core=7.8.1 -y
警告：常见问题：如果安装速度慢怎么办？解决办法：配置国内镜像源，比如添加清华镜像：
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
打开 Python 交互式解释器，输入以下代码验证核心功能：
import OCC
from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeBox
# 创建一个 10x20x30 的立方体
box = BRepPrimAPI_MakeBox(10, 20, 30).Shape()
print("立方体创建成功！" if not box.IsNull() else "创建失败")
如果输出'立方体创建成功！'，恭喜你已经跨过了第一道门槛！
执行以下命令克隆官方示例仓库：
git clone <repository_url>
cd pythonocc-core/test
选择一个基础示例运行，体验 3D 建模的乐趣：
# 运行带 GUI 的显示示例（需要有桌面环境）
python core_display_tkinter_unittest.py
成功运行后，你将看到一个包含 3D 立方体的窗口，尝试用鼠标拖动可以旋转视角，滚轮缩放模型。
提示：如果缺少 GUI 库报错？执行以下命令补充安装：
conda install -c conda-forge pyqt6（或 pyside6/tkinter/wxpython）
PythonOCC-Core 提供多种 GUI 后端，各有特点：
| 可视化后端 | 安装命令 | 特点 |
|---|---|---|
| Tkinter | 内置无需额外安装 | 轻量级，启动快，适合简单演示 |
| PyQt6 | conda install pyqt6 | 功能丰富，企业级应用首选 |
| wxPython | conda install wxpython | 跨平台性好，界面原生感强 |
尝试不同的后端示例：
# PyQt5 版本
python core_display_pyqt5_unittest.py
# PySide6 版本
python core_display_pyside6_unittest.py
通过运行专项测试，确认核心功能正常工作：
# 测试几何创建功能
python test_core_geometry.py
# 测试拓扑操作功能
python test_core_extend_topology.py
# 测试 STL/STEP 文件读写
python test_core_extend_dataexchange.py
每个测试会自动验证数十项几何操作，全部通过则表示安装质量良好。
conda update --allconda remove --name pyocc --all批量处理几何时，使用多线程加速：
python bench_tesselator_parallel.py # 并行网格划分测试
复杂模型可视化时，降低显示精度提升速度：
from OCC.Display.SimpleGui import init_display
display, start_display, add_menu, add_function_to_menu = init_display()
display.Context.SetDeviationCoefficient(0.01) # 增大数值加快显示
通过这些资源，你可以逐步掌握从简单立方体到复杂机械零件的建模技巧，开启 Python 3D 开发之旅！
提示：示例代码中的 test_io 目录包含多种格式的 3D 模型文件，如.stp、.stl 和.glb 格式，可用于测试不同类型的文件读写功能。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online