如何在 Python 虚拟环境中嵌入 FreeCAD？
How to embed FreeCAD in a Python virtual environment?
如何使用嵌入的 FreeCAD 库设置 Python 虚拟环境，以便能够作为模块导入到脚本中？
在使用使用 FreeCAD 库创建和修改 3D 几何的 Python 脚本时，我想避免使用 FreeCAD GUI 以及依赖于在系统上安装 FreeCAD。我希望 Python 虚拟环境可以实现这一点。
我在 PyCharm 2021.1.1 中使用 Python 3.8 在 Debian 10 上的 virtualenv 中工作。
我开始使用 FreeCAD 文档作为嵌入脚本的基础：
https://wiki.freecadweb.org/Embedding_FreeCAD
在一次尝试中，我从 Debian 下载并解压了 .deb 包，注意获取每个依赖项所需的正确版本。在另一次尝试中，我复制了 FreeCAD flatpak 安装的内容，因为它应该包含 FreeCAD 依赖的所有库。
将要导入的库放在虚拟机文件夹中后，我在各种尝试中用sys.path.append() 和PyCharm 的Project Structure 工具指向它们。在这两种情况下，虚拟环境都会检测到 FreeCAD.so 所在的位置，但无法找到其任何依赖项，即使位于同一文件夹中也是如此。显式导入这些依赖项时，它们每个都有相同的问题。当导入失败时，这会导致死胡同，因为它没有根据 Python:
定义模块导出函数
ImportError: dynamic module does not define module export function (PyInit_libnghttp2)
我似乎正在寻找一个很长的断开的依赖链，即使我提供了所需的库并告知 Python 它们所在的位置。
我将不胜感激关于如何执行此操作的直接说明或指向描述在 Python 虚拟环境中导入 FreeCAD 库的文档的指针，因为我还没有遇到任何具体的事情。
我之前遇到过几个似乎有类似意图但没有答案的问题：
Embedding FreeCAD in python script
Is it possible to embed Blender/Freecad in a python program?
Conda 的类似问题侧重于从主机系统导入库，而不是将它们嵌入到虚拟环境中：
其他人在 FreeCAD 论坛上的问题无人回答：
https://forum.freecadweb.org/viewtopic.php?t=27929
编辑：
弄清楚这一点是一次很棒的学习经历。将依赖项拼凑在一起的问题在于，要使该方法奏效，从 FreeCAD 及其依赖项到 Python 解释器及其依赖项的所有内容似乎都需要构建在它们所依赖的库的相同版本上以避免导致导致一切崩溃的分段错误。这意味着从 Flatpak 安装中获取它所依赖的 FreeCAD 模块和库的想法在理论上并不可怕，因为所有部分都是使用相同的库版本构建在一起的。我只是无法解决问题，大概是由于包含的库的位置以及难以为包含的 Python 解释器识别可执行文件。最后，我查看了 FreeCAD AppImage 的内容，结果发现在一个文件夹结构中包含了所需的一切，该文件夹结构似乎非常符合 PyCharm 和 Python 对模块和库的期望.
这就是我让 FreeCAD 与 PyCharm 和 virtualenv 一起工作的方法：
下载 FreeCAD AppImage
https://www.freecadweb.org/downloads.php
使 AppImage 可执行
chmod -v +x ~/Downloads/FreeCAD_*.AppImage
创建用于提取 AppImage 的文件夹
mkdir -v ~/Documents/freecad_appimage
从文件夹中提取 AppImage（注意：这会扩展到接近 30000 个文件，需要超过 2 GB 的磁盘 space）
cd ~/Documents/freecad_appimage
~/Downloads/./FreeCAD_*.AppImage --appimage-extract
为 PyCharm 项目创建文件夹
mkdir -v ~/Documents/pycharm_freecad_project
使用提取的 AppImagePython 解释器创建 pycharm 项目
Location: ~/Documents/pycharm_freecad_project
New environment using: Virtualenv
Location: ~/Documents/pycharm_freecad_project/venv
Base interpreter: ~/Documents/freecad_appimage/squashfs-root/usr/bin/python
Inherit global site-packages: False
Make available to all projects: False
将包含 FreeCAD.so 库的文件夹作为 Content Root 添加到 PyCharm Project Structure 并标记为 Sources（通过这样做，您不必设置 PYTHONPATH 或 sys.path 值，因为 PyCharm 向解释器提供模块位置信息)
File: Settings: Project: Project Structure: Add Content Root
~/Documents/freecad_appimage/squashfs-root/usr/lib
在此之后 PyCharm 有一段时间忙于索引文件。
在PyCharm和运行命令中打开Python控制台以检查基本功能
import FreeCAD
创建 python 具有示例功能的脚本
import FreeCAD
vec = FreeCAD.Base.Vector(0, 0, 0)
print(vec)
运行 脚本
调试脚本
到目前为止，我在脚本中使用的所有 FreeCAD 功能都有效。然而，一个问题似乎是 FreeCAD 模块需要在 Path 模块之前导入。否则 Python 解释器以代码 139 退出（被信号 11 中断：SIGSEGV）。
PyCharm 有几个问题：它在导入名称下显示一条红色波浪线，并声称发生了错误，因为“没有名为 'FreeCAD' 的模块”，尽管该脚本 运行ning 非常完美。此外，PyCharm 无法在代码视图中提供代码完成，即使它设法在它的 Python 控制台中这样做。我正在创建新问题来解决这些问题，如果找到解决方案，我会在此处更新信息。
如何使用嵌入的 FreeCAD 库设置 Python 虚拟环境，以便能够作为模块导入到脚本中？
在使用使用 FreeCAD 库创建和修改 3D 几何的 Python 脚本时，我想避免使用 FreeCAD GUI 以及依赖于在系统上安装 FreeCAD。我希望 Python 虚拟环境可以实现这一点。
我在 PyCharm 2021.1.1 中使用 Python 3.8 在 Debian 10 上的 virtualenv 中工作。
我开始使用 FreeCAD 文档作为嵌入脚本的基础：
https://wiki.freecadweb.org/Embedding_FreeCAD
在一次尝试中，我从 Debian 下载并解压了 .deb 包，注意获取每个依赖项所需的正确版本。在另一次尝试中，我复制了 FreeCAD flatpak 安装的内容，因为它应该包含 FreeCAD 依赖的所有库。
将要导入的库放在虚拟机文件夹中后，我在各种尝试中用sys.path.append() 和PyCharm 的Project Structure 工具指向它们。在这两种情况下，虚拟环境都会检测到 FreeCAD.so 所在的位置，但无法找到其任何依赖项，即使位于同一文件夹中也是如此。显式导入这些依赖项时，它们每个都有相同的问题。当导入失败时，这会导致死胡同，因为它没有根据 Python:
定义模块导出函数ImportError: dynamic module does not define module export function (PyInit_libnghttp2)
我似乎正在寻找一个很长的断开的依赖链，即使我提供了所需的库并告知 Python 它们所在的位置。
我将不胜感激关于如何执行此操作的直接说明或指向描述在 Python 虚拟环境中导入 FreeCAD 库的文档的指针，因为我还没有遇到任何具体的事情。
我之前遇到过几个似乎有类似意图但没有答案的问题：
Embedding FreeCAD in python script
Is it possible to embed Blender/Freecad in a python program?
Conda 的类似问题侧重于从主机系统导入库，而不是将它们嵌入到虚拟环境中：
其他人在 FreeCAD 论坛上的问题无人回答：
https://forum.freecadweb.org/viewtopic.php?t=27929
编辑：
弄清楚这一点是一次很棒的学习经历。将依赖项拼凑在一起的问题在于，要使该方法奏效，从 FreeCAD 及其依赖项到 Python 解释器及其依赖项的所有内容似乎都需要构建在它们所依赖的库的相同版本上以避免导致导致一切崩溃的分段错误。这意味着从 Flatpak 安装中获取它所依赖的 FreeCAD 模块和库的想法在理论上并不可怕，因为所有部分都是使用相同的库版本构建在一起的。我只是无法解决问题，大概是由于包含的库的位置以及难以为包含的 Python 解释器识别可执行文件。最后，我查看了 FreeCAD AppImage 的内容，结果发现在一个文件夹结构中包含了所需的一切，该文件夹结构似乎非常符合 PyCharm 和 Python 对模块和库的期望.
这就是我让 FreeCAD 与 PyCharm 和 virtualenv 一起工作的方法：
下载 FreeCAD AppImage
https://www.freecadweb.org/downloads.php
使 AppImage 可执行
chmod -v +x ~/Downloads/FreeCAD_*.AppImage
创建用于提取 AppImage 的文件夹
mkdir -v ~/Documents/freecad_appimage
从文件夹中提取 AppImage（注意：这会扩展到接近 30000 个文件，需要超过 2 GB 的磁盘 space）
cd ~/Documents/freecad_appimage
~/Downloads/./FreeCAD_*.AppImage --appimage-extract
为 PyCharm 项目创建文件夹
mkdir -v ~/Documents/pycharm_freecad_project
使用提取的 AppImagePython 解释器创建 pycharm 项目
Location: ~/Documents/pycharm_freecad_project
New environment using: Virtualenv
Location: ~/Documents/pycharm_freecad_project/venv
Base interpreter: ~/Documents/freecad_appimage/squashfs-root/usr/bin/python
Inherit global site-packages: False
Make available to all projects: False
将包含 FreeCAD.so 库的文件夹作为 Content Root 添加到 PyCharm Project Structure 并标记为 Sources（通过这样做，您不必设置 PYTHONPATH 或 sys.path 值，因为 PyCharm 向解释器提供模块位置信息)
File: Settings: Project: Project Structure: Add Content Root
~/Documents/freecad_appimage/squashfs-root/usr/lib
在此之后 PyCharm 有一段时间忙于索引文件。
在PyCharm和运行命令中打开Python控制台以检查基本功能
import FreeCAD
创建 python 具有示例功能的脚本
import FreeCAD
vec = FreeCAD.Base.Vector(0, 0, 0)
print(vec)
运行 脚本
调试脚本
到目前为止，我在脚本中使用的所有 FreeCAD 功能都有效。然而，一个问题似乎是 FreeCAD 模块需要在 Path 模块之前导入。否则 Python 解释器以代码 139 退出（被信号 11 中断：SIGSEGV）。
PyCharm 有几个问题：它在导入名称下显示一条红色波浪线，并声称发生了错误，因为“没有名为 'FreeCAD' 的模块”，尽管该脚本 运行ning 非常完美。此外，PyCharm 无法在代码视图中提供代码完成，即使它设法在它的 Python 控制台中这样做。我正在创建新问题来解决这些问题，如果找到解决方案，我会在此处更新信息。