sitdraw

如何安装并使用 bun：安装、运行脚本、添加依赖并启动项目

按官方步骤安装 bun，跑通一个脚本，添加一个包，并用 bun init 启动第一个项目。

要在本机用 bun 跑 JavaScript 或 TypeScript，先完成四件事：按官方方式安装，bun 直接跑一个脚本，bun add 加一个包，再用 bun init 建第一个项目。

按 bun.sh/docs/installation 走，不要猜安装包名。核心检索词是 如何安装 bun、bun add，以及 bun init。安装入口在 bun.sh。

bunOven 的命令名
add写入 package.json
init生成第一个项目

先按系统装官方二进制

macOS 与 Linux

官方脚本：curl -fsSL https://bun.sh/install | bash。也可以 brew install oven-sh/bun/bun。装完重开终端，跑 bun --version。

Windows

PowerShell：powershell -c "irm bun.sh/install.ps1 | iex"。装完新开会话，确认 bun 在 PATH 里。

步骤命令要注意
安装bun --version当前 shell 要能找到官方二进制
跑脚本bun hello.ts可直接跑 .js / .ts，不必先编译
加依赖bun add zod包名以 npm registry 为准；会更新 lockfile
建项目bun init目录里应有 package.json

安装、跑脚本、加包、建项目

  1. 01
    安装并确认版本

    按 bun.sh/docs/installation 选脚本或 Homebrew。装完 bun --version 应打印版本。找不到命令就重开终端，检查 PATH。升级用 bun upgrade。

  2. 02
    运行一个脚本

    写 hello.ts（或 hello.js），执行 bun hello.ts。bun 自带运行时，TypeScript 不必先走 tsc。有 package.json 脚本时用 bun run <script>。

  3. 03
    添加一个包

    在项目目录执行 bun add zod（示例）。bun 会解析依赖、写 lockfile。失败时核包名与网络，不要手改半截 lockfile。

  4. 04
    启动第一个项目

    空目录里执行 bun init，按提示生成 package.json 与入口文件。然后 bun run 默认脚本，或直接 bun index.ts。已有仓库用 bun install 装依赖。

curl -fsSL https://bun.sh/install | bash
bun --version
printf 'console.log("ok")\n' > hello.ts
bun hello.ts
mkdir myproject && cd myproject
bun init
bun add zod
# 写好入口后：
bun index.ts
必须用官方安装脚本吗？
不必。文档还列出 Homebrew、npm、Scoop 等渠道。选一种，装完用 bun --version 验证即可。不要混装多个互抢 PATH 的副本。
还要先装 Node 才能跑 TypeScript 吗？
日常不必。bun 自带运行时，可直接执行 .ts。若项目脚本写死 node，仍可能需要对照官方兼容说明。
bun add 和 npm install 有何不同？
目标都是往项目加依赖。bun add 用 bun 的解析器与 lockfile（bun.lock）。不要在同一目录轮流用 npm / pnpm / bun 各写一份锁，以免对不齐。
装完就能当白板用吗？
不能。这是本机 JavaScript 工具链。要对着同一张图说话时，再开 sitdraw。

先让 bun 进 PATH

没跑通 bun --version 之前，不要把 init 失败当成项目模板问题。多数是当前终端还没加载安装脚本改过的 PATH。

开始画