通义灵码生成数据字典这一功能，并非简单右键点击就能自动导出表结构说明。其运行机制依赖于 MCP（Model Control Protocol）插件与 SQLite 数据源的协同配合——你必须先让工具“识别”到数据库文件，再结合建表语句与字段注释的上下文，才能生成一份真正可读、符合业务含义的字段说明文档。换言之，前期准备与规范化写法缺一不可。

配置 SQLite 数据源并启用 mcp-server-sqlite

打开 VS Code，确保当前工作区根目录下已经存在 demo.sqlite 文件（如果没有，先用 touch demo.sqlite 创建一个空的数据库文件）。然后按下 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（Mac），输入 “Preferences: Open Settings (JSON)”，在打开的 settings.json 末尾添加 mcp-server-sqlite 配置块。这里有一个关键细节：--db-path 的值必须填写为 demo.sqlite 的绝对路径，例如 /Users/xxx/demo/demo.sqlite。路径一旦写错，后续所有数据字典操作都会返回空结果——这一步经常被忽略，建议在配置完成后先做一次快速验证。

保存 settings.json，随后重启 VS Code，让通义灵码重新加载 MCP 插件配置。至此，数据源才算真正准备就绪。

在 SQL 文件中编写建表语句并触发字段解析

接下来在项目中新建一个 schema.sql 文件，写入标准的 CREATE TABLE 语句。例如：

CREATE TABLE orders (id INTEGER PRIMARY KEY, user_id INTEGER NOT NULL, amount REAL, status TEXT DEFAULT 'pending');

将光标定位在 CREATE TABLE 这一行的任意位置，按下 Alt+P（Windows）或 Option+P（Mac），输入一条自然语言指令：“为这张表生成中文数据字典，包含字段名、类型、是否为空、默认值、业务含义说明”。通义灵码会自动识别当前 SQL 上下文中的表结构，并调用 mcp-server-sqlite 读取 schema 元信息，最终生成一份带语义解释的字段说明表格。

不过这里有一个常见的踩坑点：建表语句的规范性直接影响输出质量。如果字段缺失 NOT NULL 或 DEFAULT 等约束，生成的“是否为空”和“默认值”列就会显示为“未知”——这就像填表时漏了必填项，工具自然只能返回一个问号。因此，书写表结构时务必把约束写完整。

从已有数据库直接提取字段注释生成字典

如果你手头已经有一个现成的 SQLite 数据库，无需重新编写建表语句，也有两种方法可以快速生成数据字典。

方法一：使用通义灵码对话面板提问
点击右侧通义灵码图标打开聊天面板，在输入框中粘贴如下指令：
“请读取 SQLite 数据库中 orders 表的所有字段，结合字段类型、约束以及可能存在的列注释（如通过 sqlite_master 或 comments 表存储），生成一份 Markdown 格式的数据字典。字段包括：字段名、数据类型、是否主键、是否允许为空、默认值、备注说明。”

方法二：在 .sql 文件中执行 PRAGMA 查询后触发分析
新建一个 query.sql，输入 PRAGMA table_info(orders);，运行该语句（需要安装 VS Code SQLite 插件或使用终端 sqlite3 命令）。然后选中查询结果，右键选择 “Ask with Tongyi Lingma”。它会将原始的元数据转译成带有业务语言的字段说明。

有一点需要提醒：SQLite 本身不支持列级 COMMENT 语法。如果你已经在表结构中使用 -- 注释标注了字段含义（例如 user_id INTEGER NOT NULL -- 用户唯一标识），通义灵码可以自动提取这段文本作为“备注说明”内容。因此，写注释时一定要采用这种行内注释格式，从而充分利用这些宝贵的业务描述信息。