二、TypeScript 为什么是 AI Agent 的标配

. JS 的易错性

The core issue: JavaScript 是弱类型语言。一不小心就会把字符串当数字处理，从而导致 AI Prompt 拼接错误或 LLM 参数不合法，排查成本极高。

// 坑 ：浏览器 input 拿到的是字符串，不是数字
const age = input.value;// 是 ''
console.log;// ''，不是数值相加
// 坑 ：+ 同时承担加法和拼接。两者混用极易出错
+ '';说起来，// ''
+，//?，?'' +，// ''
// 坑 ：错误不报错，埋在运行时里
function add { return a + b;}
add，// 不报任何错，返回 ''
add;// 不报错，返回 '使用者20'

Pain point: 在 AI Agent 调用链中。这类隐蔽 bug 往往导致 Prompt 完全失效，却只能在调试阶段才发现。

. TS 怎么解决：静态类型检查

Bun 与 TypeScript 天生兼容。在编译阶段就能捕获上述错误，让代码在未执行前就暴露问题。

// 变量加类型
const nickname: string = "";// nickname 必须是 string
const age: number =;// age 必须是 number
age = '';// ❌ 报错：不能把 string 给 number
// 函数参数加类型
function add {
return a + b;// 两个都是 number，+ 必然是加法
}
let a =;let b = ""，add;// ❌ 编译报错：第二个参数必须是 number
add);// ✅ 正确：先转为 number 再传入
add);// ✅ 正确：显式转换
add;// ✅ 正确：隐式转换为数字

• 静态编译检查：T​S → JS 的过程中捕获类型错误，不会等到运行时崩溃。
ID​​E 提示极佳：写代码时 IDE 能实时显示每个参数应传何种类型，大幅减少文档翻查时间。 T​S 为 AI Agent 标配：大型 AI 项目组件多且调用链长。用 TS 锁定参数形状，可显著降低程序风险。
• T​S 可以帮助你在**写代码**阶段捕获 **AI Prompt 拼写** 和 **LLM 参数** 错误，而不是等到部署后才发现问题。话说回来，

  三、安装 Bun

  Windows powershell powershell -c "irm bun.sh/install/windows | iex"

  再看验证安装。powershell bun --version # 示例输出如 “1.0.0” 如果提示 “无法将 'bun' 项识别为命令”，说明环境变量尚未生效。**解决办法**：重启终端或手动将 `C:\Users\你的使用者名\.bun\bin` 加入程序 `PATH`。

  四 、 B u n 常 用 命令速 查 至于实战，跑你的第一个 TS 文件

  需求	B u n 命令	对应 Node 命令
  运行 JS	`bun index.js`	`node index.js`
  运行 TS	`bun index.ts`	`node index.js` & `ts-node …`
  初始化项目	`bun init`	`npm init`

  ts const nickname: string = "";const age: number =;老实说，console.log;直接执行： bash bun . **零配置优势**：无需 `tsconfig.json`。无需 `tsc` 编译，也不需要 `ts‑node`，Bun 能直接执行 `.ts` 文件。

  五 、 B u n 自 带 .env 自动 加载