nvim-treesitter-textobjects项目中的赋值语句文本对象优化探讨

在代码编辑场景中，对赋值语句的操作是高频行为。本文基于社区讨论，深入分析如何优化nvim-treesitter-textobjects插件中的赋值语句文本对象设计，使其更符合开发者直觉。

当前实现的问题分析

现有@assignment.outer文本对象存在以下行为特征：

1. 仅捕获赋值符号右侧表达式（RHS）和左侧变量名（LHS）
2. 不包含声明关键字（如const/let/var）和语句结束符（如分号）
3. 导致删除整个赋值语句时需要额外操作

典型示例（光标位置用*表示）：

const/*光标*/[[foo = "bar"]] // 当前@assignment.outer捕获范围
[[const foo = "bar";]]       // 期望捕获范围

技术方案对比

方案一：新增@assignment.full文本对象

• 优点：语义明确，不与现有实现冲突
• 缺点：增加API复杂度，需要维护新查询规则
• 实现示例：

(lexical_declaration
  (variable_declarator
    name: (_) @assignment.lhs
    value: (_) @assignment.rhs)) @assignment.full

方案二：修改现有@assignment.outer行为

• 优点：保持API简洁，符合用户直觉
• 挑战：需要同步修改所有语言查询规则
• 行为变化：
  • 原inner改为匹配当前outer行为
  • 新outer包含完整语句

多语言适配考量

该修改需要保证跨语言一致性：

1. JavaScript/TypeScript的const/let/var
2. Python的变量赋值（无分号）
3. Lua的local关键字
4. 其他支持变量声明的语言

开发者实践建议

对于需要类似功能的用户，可暂时通过以下方式实现：

1. 在个人配置中添加自定义查询
2. 使用@statement文本对象（若存在）
3. 组合现有文本对象操作（如daa配合v%）

总结

优化赋值语句文本对象能显著提升代码编辑效率。经过讨论，社区更倾向于方案二——通过扩展@assignment.outer的捕获范围来实现完整语句操作，这既保持了API的简洁性，又符合开发者对"赋值操作"的心理模型。该改进需要谨慎处理各语言查询规则的一致性，是文本对象设计原则与实际使用体验的典型平衡案例。