TypeScript TS1109 — 此处应为表达式

症状

错误“TypeScript TS1109 — 此处应为表达式”指向一个明确的失效模式。下面依次给出症状、定位该原因的检查命令、根本原因、修复方案，以及证明修复有效的验证步骤。

可观察到的症状包括：

• error TS1109: Expression expected
• 插入符指向逗号或运算符之后
• 某行看似正常，但附近的改动引入了错误

诊断

先在隔离环境中复现故障，再按顺序执行以下检查，逐步缩小范围。

步骤 1

npx tsc --noEmit --pretty 2>&1 | grep -A 3 TS1109

pretty 输出会以下划线标出意外 token 及所在行，精确定位改动。

步骤 2

grep -n "return\|=>\|(\([^)]*$" src/*.ts | head

未闭合的括号或无函数体的箭头函数常在下行表现为“此处应为表达式”。

常见诱因（按出现频率排序）：

• 尾随逗号、运算符或点号后面没有内容
• 对象字面量或调用缺少值或右括号
• 可选链或展开运算符缺少操作数

根因

TS1109 是解析错误：语法在需要表达式处遇到了不能作为表达式起始的 token。它几乎总是紧随不完整的前置结构，如悬空的运算符或未闭合的括号。

修复

补全表达式、移除悬空的运算符或逗号、配平括号，再运行解析器确认错误消除或位置变化。

注意：只修报告行而不检查上一行，可能让真正的语法错误留着。

// ❌ trailing comma after the last element in a context that disallows it
// const x = [1, , ];

// ❌ arrow with no body
// const f = () => ;

// ✅
const x = [1, 2, 3];
const f = () => 42;
const obj = { a: 1 };

验证

运行 tsc –noEmit，确认 TS1109 消失且无新增解析错误；格式化文件以捕获括号不匹配。

修复后补充一条回归测试，复现原始症状，防止问题再次出现。

这类故障通常是环境问题而非纯逻辑错误，因此在缺陷记录中应写明完整命令、环境变量与工作目录。请用最小的脚本复现，待最小用例清楚后再扩大范围。为这类故障准备一份简短的排查清单，能显著减少下次排障时间。