# 使用 Bun 运行文件

URL: https://caijiao.org/bun/setup/run-script
Source: docs/bun/setup/run-script.md
Description: 介绍如何使用 Bun 运行 JavaScript 或 TypeScript 文件，快速启动项目。

Bun 提供了简便的命令行工具，可以快速运行 [JavaScript](/javascript/) 或 TypeScript 文件。无论是开发过程中测试代码，还是运行单个脚本，[Bun](/bun/) 都能提供快速的启动体验。

## 1. 运行 JavaScript 文件

要运行一个 JavaScript 文件，使用以下命令：

```bash
bun run filename.js
````

Bun 会直接执行该文件中的代码，支持标准的 ES 模块（ESM）。

## 2. 运行 TypeScript 文件

Bun 也原生支持运行 TypeScript 文件，无需额外的配置或转译。只需使用以下命令运行 `.ts` 文件：

```bash
bun run filename.ts
```

Bun 会自动编译 TypeScript 代码并执行。

## 3. 运行带参数的脚本

你可以向 Bun 传递命令行参数，类似于 Node.js。例如，运行一个带参数的脚本：

```bash
bun run filename.js arg1 arg2
```

在脚本中，`process.argv` 将包含传递给脚本的参数。

## 4. 使用 `bun exec` 运行命令

除了直接运行文件，Bun 还提供了 `bun exec` 命令来执行 JavaScript 脚本或外部命令：

```bash
bun exec node -v
```

这将通过 Bun 启动 Node.js，并显示版本信息。

## 总结

Bun 提供了极为简便的命令行工具来运行 [JavaScript](/javascript/) 和 TypeScript 文件。无论是开发调试还是运行任务，Bun 都能提供快速、高效的运行体验。