跳转到内容
CoderClaw CoderClaw

Node + tsx 崩溃

Node + tsx “__name is not a function” 崩溃

Section titled “Node + tsx “__name is not a function” 崩溃”

概述

Section titled “概述”

通过 Node 使用 tsx 运行 CoderClaw 时，启动阶段报错：

[coderclaw] Failed to start CLI: TypeError: __name is not a function
    at createSubsystemLogger (.../src/logging/subsystem.ts:203:25)
    at .../src/agents/auth-profiles/constants.ts:25:20

此问题在开发脚本从 Bun 切换到 tsx 后出现（提交 2871657e，2026-01-06）。相同的运行路径在 Bun 下正常工作。

环境

Section titled “环境”
  • Node: v25.x（在 v25.3.0 上观察到）
  • tsx: 4.21.0
  • 操作系统: macOS（其他运行 Node 25 的平台也可能复现）

复现步骤（仅 Node）

Section titled “复现步骤（仅 Node）”
Terminal window
# 在仓库根目录
node --version
pnpm install
node --import tsx src/entry.ts status

仓库内最小复现

Section titled “仓库内最小复现”
Terminal window
node --import tsx scripts/repro/tsx-name-repro.ts

Node 版本检查

Section titled “Node 版本检查”
  • Node 25.3.0：失败
  • Node 22.22.0（Homebrew node@22）：失败
  • Node 24：尚未安装，需要验证

说明 / 假设

Section titled “说明 / 假设”
  • tsx 使用 esbuild 转换 TS/ESM。esbuild 的 keepNames 会生成一个 __name 辅助函数，并用 __name(...) 包裹函数定义。
  • 崩溃表明 __name 存在但在运行时不是函数，这意味着在 Node 25 的加载器路径中该辅助函数缺失或被覆盖。
  • 其他 esbuild 使用者也报告过类似的 __name 辅助函数缺失或被重写的问题。

回归历史

Section titled “回归历史”
  • 2871657e（2026-01-06）：脚本从 Bun 改为 tsx，使 Bun 成为可选项。
  • 在此之前（Bun 路径），coderclaw status 和 gateway:watch 均正常工作。

解决方法

Section titled “解决方法”
  • 开发脚本使用 Bun（当前临时回退方案）。
  • 使用 Node + tsc watch，然后运行编译产物：
    Terminal window
    pnpm exec tsc --watch --preserveWatchOutput
    node --watch coderclaw.mjs status
  • 已在本地确认：pnpm exec tsc -p tsconfig.json + node coderclaw.mjs status 在 Node 25 上可正常运行。
  • 如果可能，在 TS 加载器中禁用 esbuild 的 keepNames（防止插入 __name 辅助函数）；tsx 目前不提供此配置项。
  • 在 Node LTS（22/24）上测试 tsx，确认该问题是否为 Node 25 特有。

参考资料

Section titled “参考资料”

后续步骤

Section titled “后续步骤”
  • 在 Node 22/24 上复现，确认是否为 Node 25 回归问题。
  • 测试 tsx nightly 版本，或在存在已知回归时固定到早期版本。
  • 如果在 Node LTS 上也能复现，则向上游提交包含 __name 堆栈跟踪的最小复现。