现在已经 4202 年了，C++ 模块已经经过了长足的发展，但就模块是否得到工具支持仍然有历史遗留的争议。

本文将说明在 VSCode 下配合 XMake 和 Clangd 是可行方案，并给出指导。

先说结论，配置 xmake.lua 加上 compile_commands.json 就足够了，不需要别的操作。

需求：将 Latex 公式转为图片，svg 或 png 格式。

其实我们熟悉的 matplotlib 就支持这个功能，可以应付一些简单的情况（复杂的后面说）。

基本用法

import matplotlib.font_manager as mfm
from matplotlib.mathtext import math_to_image

prop = mfm.FontProperties(math_fontfamily='stix', size=64, weight='bold')
math_to_image(r"$\sum_{i=1}^n i$", "path/to/output.svg", prop=prop, dpi=72)

Python 有着和 C++ 极为相似的 import 系统，都是 include once。这样就很容易产生循环包含/导入的问题。

从依赖关系角度，确实可以通过将依赖关系构建成树的方式来避免循环导入。但是当使用 typing 的时候，情况就不一样了……

测试环境配置

Ubuntu 22.04，配置 conda。

从 清华源 安装，直接下载 latest 就行。

部署失败，提示无法写入

参考 https://zhuanlan.zhihu.com/p/598824876

需要给 write 权限

操作：Settings / Actions / General / Workflow permissions，选择 Read and write permissions。

跨仓库部署失败，提示无权限

尝试用 Clangd 代替 Intellisense 进行实时语法检测，但是遇到了很多问题。
配置基础参考了 https://zhuanlan.zhihu.com/p/566506467。

Prerequisite

VSCode 安装 clangd 扩展。

如果系统没有安装 clangd 它会自己下载一个到插件共享文件目录，并且设置 clangd 的路径。

装了新版 Python 后使用 matplotlib 出现了这样的问题：

****.py: UserWarning: Matplotlib is currently using agg, which is a non-GUI backend, so cannot show the figure.
  plt.show()