Feature request: Expose original source text for TSqlFragment (Debugger & API usability)

未关闭

#203 创建于 2026年4月24日 0 条评论 1 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 4/5
预计耗时: 3-5 天
新手友好度: 45/100

Issue 类型: 功能
描述清晰度: 基本清楚
活跃度: 冷清
技术栈: csharp
领域: api, databases

调研方向

从 TSqlFragment API 及其现有成员 FirstTokenIndex、LastTokenIndex、ScriptTokenStream、StartOffset 和 FragmentLength 开始。检查片段如何表示其源范围，并确定所公开文本的预期行为，包括调试和消费者使用时的便利性。完成标准是：片段能够提供其原始源文本，而无需每个消费者手动重新构建，并在 repository 支持测试的地方提供相应的覆盖。

由索引模型根据 Issue 内容生成。

描述

Problem

Working with Microsoft.SqlServer.TransactSql.ScriptDom is unnecessarily hard in practice,
especially during debugging.

TSqlFragment objects do not expose the original source text they represent.
Instead, consumers must manually reconstruct the SQL text via:

FirstTokenIndex / LastTokenIndex
ScriptTokenStream
or StartOffset / FragmentLength

This makes debugging extremely cumbersome:
in Visual Studio, inspecting a fragment does not show the SQL code,
only a large object graph with token indices.

This significantly affects developer productivity and discoverability of the AST.

Current workaround (non-trivial)

Every consumer needs to implement helper code such as:

    extension(TSqlFragment node)
    {
        public string SourcePart => string.Join("",
            node
                .ScriptTokenStream
                .Skip(node.FirstTokenIndex)
                .Take(node.LastTokenIndex - node.FirstTokenIndex + 1)
                .Select(i => i.Text)
                );
    }

主要语言: GAP
星标: 277
派生: 43
平均合并: 6 天 17 小时
30 天内合并 PR: 3