Taichi 在 Linux 上启动报 CXXABI_1.3.11 not found 怎么办？

Taichi 在 Linux 上启动报 CXXABI_1.3.11 not found 怎么办？

【免费下载链接】taichiProductive, portable, and performant GPU programming in Python.项目地址: https://gitcode.com/GitHub_Trending/ta/taichi

在 Linux（尤其是 Ubuntu 16.04）上运行 Taichi 程序时，进程可能在启动阶段就崩溃，终端里出现类似这样的报错：

/usr/lib/libstdc++.so.6: version `CXXABI_1.3.11' not found

这说明系统里加载的libstdc++.so.6版本过旧，不包含 Taichi 需要的CXXABI_1.3.11符号。Taichi 官方 FAQ（安装问题排查）把这一条列在 "Linux issues" 下，给出的原因是：你可能在使用 Ubuntu 16.04，官方文档给出的解决办法是通过ubuntu-toolchain-rPPA 升级系统的libstdc++6包。本文按这条路径整理出完整的操作与验证步骤。

先确认报错与环境

在动手改系统之前，先核对两个前提，确认当前问题确实属于这一类：

1. 报错信息与文档描述一致，即崩溃信息中包含/usr/lib/libstdc++.so.6: version 'CXXABI_1.3.11' not found；
2. 系统符合 Taichi 的运行前提：64 位 Linux，Python 版本为 3.7 / 3.8 / 3.9 / 3.10（64 位）。Python 版本可以用 FAQ 文档里给出的命令确认：

python3 -c "import sys;print(sys.version[:sys.version.find('.', 2)])" # 期望打印 3.7、3.8、3.9 或 3.10

Taichi 本身通过 PyPI 安装（pip install taichi，见 Hello, World!），这一步与报错无关——CXXABI_1.3.11问题出在系统 C++ 运行时库，而不是 pip 包本身。

执行修复：从 PPA 升级 libstdc++6

以下是 FAQ 文档给出的完整命令序列：

sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y sudo apt-get update sudo apt-get install libstdc++6

执行前需要注意这些命令的副作用和前提：

• 三条命令都需要 root 权限（通过sudo执行），执行环境需要有管理员密码；
• 第一条命令会向系统的 apt 源中添加ubuntu-toolchain-r/test这个 PPA，即修改系统的软件源配置；
• 第二条命令刷新本地 apt 索引；
• 第三条命令安装（或升级）系统的libstdc++6库，这是全系统共用的 C++ 运行时库，版本变化会作用于机器上所有依赖它的程序。

三条命令必须按顺序执行：先加源、再刷新索引、最后安装，顺序颠倒会拿不到新版包。FAQ 说明中注明该方案对应的是 "Ubuntu 16.04" 场景，文档中链接到的是社区讨论帖的解决方案；如果你的发行版不是 Ubuntu，文档没有给出对应的操作步骤，不建议照搬。

验证修复是否生效

重新运行之前崩溃的 Taichi 程序即可。如果手头没有现成的脚本，可以用下面这个最小脚本核对（ti.cpu与ti.gpu是ti.init()文档中说明的两种后端取值，见 Hello, World!）：

import taichi as ti ti.init(arch=ti.cpu)

把它保存为.py文件（例如check_taichi.py），进入该文件所在目录后运行：

python3 check_taichi.py

判断标准只有一个：之前那个/usr/lib/libstdc++.so.6: version 'CXXABI_1.3.11' not found崩溃不再出现，ti.init()正常执行完成，就说明系统库升级生效，Taichi 可以正常启动了。

仍然报同样的错时怎么办

• 先确认三条命令都是按顺序执行且退出码为 0，尤其是第一条add-apt-repository是否成功（它决定了后两步能否拿到新版本的libstdc++6）；
• FAQ 文档将 "以上都解决不了" 的情况统一归到 "Other issues"：通过 Taichi 项目的 issue 渠道反馈，并附上完整的崩溃输出，便于维护者定位（入口见 安装问题排查 文档）。

另外提醒一个边界：这个错误只在进程启动/加载阶段出现一次，它和 CUDA、OpenGL 等其他 Linux 启动报错是不同类别的问题，不要混用 FAQ 中那些TI_ENABLE_CUDA=0、TI_ENABLE_OPENGL=0之类的环境变量方案来处理CXXABI报错——文档没有说明它们对这个问题有任何作用。

【免费下载链接】taichiProductive, portable, and performant GPU programming in Python.项目地址: https://gitcode.com/GitHub_Trending/ta/taichi