Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

create-tsrouter-app scaffold fails out of the box with pnpm on Linux

未关闭
#395 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
48/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
冷清
领域
build-system, cli

调研方向

首先定位 TanStack Start scaffold template 及其 package.json 中的依赖定义,然后在 Linux 上使用 pnpm install 和 pnpm dev 重现该故障。调查报告中的 esbuild postinstall 和 lightningcss native-binary 错误;当一个刚 scaffold 出来的项目无需手动修改依赖即可完成安装并启动时,即表示完成。

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

描述

Which project does this relate to?

Router

Describe the bug

Running pnpm install and pnpm dev on a freshly scaffolded TanStack Start project fails immediately without any modifications.

Your Example Website or App

none

Steps to Reproduce the Bug or Issue

Steps to reproduce

  1. Scaffold a new project using the TanStack Start template
  2. pnpm install
  3. pnpm dev
Expected behavior

Expected behavior

A freshly scaffolded project should work after pnpm install with no manual fixes required.

Screenshots or Videos

No response

Platform

Environment

OS Linux x64 (Ubuntu)
Node v22.22.0
pnpm v10.30.1
@tanstack/react-start 1.162.4
Additional context

First error: esbuild postinstall fails with:

Error: Expected "0.27.3" but got ""

The scaffold pins esbuild@0.27.3 directly in dependencies, which has a broken postinstall script under Node 22.

Second error (after removing esbuild from dependencies and letting it be a transitive dep): lightningcss native binary missing:

Error: Cannot find module '../lightningcss.linux-x64-gnu.node'

pnpm's strict symlinking means the lightningcss-linux-x64-gnu optional dependency binary never gets linked into lightningcss's node/ directory.

主要语言
TypeScript
星标
1.3k
派生
185
平均合并
18 小时 45 分钟
30 天内合并 PR
2

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

TanStack/cli 的其他 Issue

查看 TanStack/cli 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。