vs code 不支持 kusto 查询语言（kql）原生执行，因其缺乏认证流、集群路由、结果分页等专有协议支持；官方推荐 azure data studio + kusto 扩展，唯此能完整调试 | evaluate python() 等功能。

VS Code 本身不支持 Kusto 查询语言（KQL）原生执行，必须通过插件扩展；但官方推荐路径是 Azure Data Studio + Kusto 扩展，而非 VS Code —— 这一点容易被搜索误导。

为什么 VS Code 官方不主推 Kusto 插件

Kusto（即 Azure Data Explorer）的查询执行依赖服务端计算与沙盒化 Python 环境（如 evaluate python()），客户端只负责语法高亮、参数补全和请求封装。VS Code 缺乏对 KQL 认证流、集群路由、结果分页渲染等专有协议的支持。Azure Data Studio 是微软为数据平台定制的 IDE，其 Kusto (KQL) 扩展已进入预览阶段，而 VS Code 社区暂无稳定、维护活跃的替代方案。

• VS Code 中安装的 vscode-sqltools 或第三方 KQL 插件，仅提供基础语法高亮和连接框架，无法真正执行 | evaluate python()、set query_python_debug; 等关键调试指令
• 所有 KQL 内联 Python 调试流程（包括 debug_python.py 生成、df.txt/kargs.txt 同步、断点映射）均绑定 Azure Data Studio 或 Kusto Explorer 的导出机制
• 即使强行用 VS Code 的 REST Client 插件发 KQL 请求，也需手动构造 Authorization Header、处理 ADX 的 query endpoint 和 execute payload 格式，稳定性差且无错误上下文定位能力

VS Code 可用的“类 Kusto”替代方案

如果你坚持在 VS Code 中处理 KQL 相关工作，只能作为辅助编辑器使用，核心操作仍需跳转到 Azure Data Studio：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 安装 Kusto (KQL) 语言支持插件（如 ms-kusto.kusto-language-service）：仅提供语法高亮、括号匹配、注释快捷键（Ctrl+/），不带执行能力
• 配合 REST Client 插件手动调用 ADX REST API：需预先获取 AAD token，URL 形如 https://<cluster>.kusto.windows.net/v1/rest/query</cluster>，body 必须是 JSON 格式含 db 和 csl 字段 —— 错一个字段名或引号就返回 Bad Request
• 用 vscode-sqltools 连接 PostgreSQL/MySQL 做本地模拟：适用于写逻辑原型，但无法验证 make-series、series_decompose_anomalies 等 ADX 特有函数行为

真正能调试内联 Python 的唯一路径

要完整走通 KQL + Python 调试闭环（从 set query_python_debug; 到 VS Code 断点命中），必须满足三个硬性条件：

• 运行环境是启用 Microsoft Fabric 的容量工作区，且数据库已配置 Python 插件权限
• 查询前缀明确包含 set query_python_debug;，且该语句与后续 | evaluate python() 在同一逻辑块中（中间不能有空行）
• 调试入口文件 debug_python.py 必须由 Azure Data Studio 导出生成 —— 它内置了初始化 pandas.DataFrame 和 kwargs 的模板代码，手动编写极易因列名大小写、索引类型（RangeIndex vs Int64Index）导致 KeyError 或 ValueError: setting an array element with a sequence

实际工作中最常被忽略的一点：take 或 sample 限制输入规模不是可选项，而是强制前提。哪怕只是多一行数据超出几 MB 沙盒内存上限，VS Code 调试器就会卡在 import pandas 阶段无响应，且不会抛出明确错误 —— 它只是静默失败。