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

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

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

本文描述实验室电脑（Windows11）配置过程。

字体

• 更纱黑体（可用于需要同时支持中英文等宽字体的地方，如传统终端）：https://github.com/be5invis/Sarasa-Gothic。可走镜像下载，选 SuperTTC。
• JetBrains Mono（用于代码编辑器）：https://www.jetbrains.com/lp/mono/
• Nerd Font Mono（用于美化终端）：大全：https://www.nerdfonts.com/，在 Font Download 里找想要的字体下载。实质上是在原字体的基础上扩充了符号。推荐：JetBrains Mono Nerd Font，FiraCode Nerd Font。

在 Windows 平台上，厌倦了 pwsh 动辄一两秒的启动时间？苦于没有可爱的 fish？来试试 Nushell 吧！Rust 万岁！

Nushell 安装

按照官方指示即可，此处不赘述。

• 仓库：https://github.com/nushell/nushell
• 文档：https://www.nushell.sh/
• awesome：https://github.com/nushell/awesome-nu

C# 标准库有提供 FileSystemWatcher，直接实现我们想要的监听功能。官方文档给出了示例。

自定义调色板

颜色列表

首先，我们需要获取 Quasar 支持的颜色变量列表。这个在 quasar/dist/types/api/color.d.ts 中有定义：

// color.d.ts
export type BrandColor =
  | "primary"
  | "secondary"
  | "accent"
  | "dark"
  | "positive"
  | "negative"
  | "info"
  | "warning";
type Color =
  | "red"
  | "pink"
  | "purple"
  | "deep-purple"
  | "indigo"
  | "blue"
  | "light-blue"
  | "cyan"
  | "teal"
  | "green"
  | "light-green"
  | "lime"
  | "yellow"
  | "amber"
  | "orange"
  | "deep-orange"
  | "brown"
  | "grey"
  | "blue-grey";
type ColorShade = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14;
type DetailedColor = `${Color}-${ColorShade}`;

export type NamedColor = LiteralUnion<
  BrandColor | Color | DetailedColor | keyof CustomColors
>;

用 SQLAlchemy 写 ORM 时经常需要修改数据表字段，这时一般方法是手动改数据表，还可能要处理新增的 not null 字段的默认值，比较麻烦。
因此我们选择 alembic 完成数据库迁移操作，快捷更新表结构。

操作

官网有详细教程，这里说明一下我的操作过程，列一下遇到的坑。

创建环境

假设已经用 poetry 创建好了虚拟环境。

poetry add alembic

安装

pnpm i vue-clipboard3

有些时候，我们希望能够让用户自定义网页的主题色，对于 Quasar 来说，特别是 primary。更进一步，我们希望主题色分为多阶（好比提供的 red-1，red-2 系列），均能同步改变。

Quasar 提供了 getCssVar 和 setCssVar 两个设置 CSS 变量的函数，其效果是在 DOM 根结点的 style 加上对应的变量声明。

例如 setCssVar("primary", "red")，那么它会设置 --q-primary: red，加上一个 --q- 前缀。这样所有的 primary color 都会变成设定的颜色。

前置知识：File

看过文档应该知道，素材是 FootageItem 对象。它有一个属性为 file，表示对应的源文件。这是只读的，无法修改。但是有 replace 方法，它接受一个 File 类型的参数，表示替换素材。该方法执行后，会更新素材的名称、长宽等属性。