CentOS 8平台搭建Bun开发环境的完整教程

引言

Bun是一个现代化的JavaScript运行时环境，类似于Node.js，但提供了更快的启动速度和更高效的性能。本文将详细介绍在CentOS 8系统上搭建Bun开发环境的完整步骤，帮助你快速开始使用这个新兴的JavaScript工具链。

准备工作

在开始之前，请确保：

1. 你有一台运行CentOS 8的服务器或虚拟机
2. 拥有sudo权限的用户账户
3. 基本的Linux命令行操作知识

第一步：更新系统软件包

首先，我们需要确保系统软件包是最新的：

sudo dnf update -y
sudo dnf upgrade -y

说明：
– dnf是CentOS 8默认的包管理器
– update获取最新的软件包列表
– upgrade执行实际的升级操作
– -y参数自动确认所有提示

第二步：安装基础依赖

Bun需要一些基础依赖才能正常运行：

sudo dnf install -y unzip curl git wget

关键组件：
– unzip：用于解压下载的文件
– curl和wget：用于下载文件
– git：版本控制工具（某些Bun功能需要）

第三步：安装Bun

官方提供了简单的安装脚本：

curl -fsSL https://bun.sh/install | bash

安装完成后，将Bun添加到PATH环境变量：

echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证安装：

bun --version

如果看到版本号输出（如1.0.0），说明安装成功。

第四步：配置Bun环境（可选）

设置默认包管理器

让Bun作为默认的JavaScript包管理器：

bun setup --use-yarn # 或者 --use-npm，取决于你的偏好

启用Shell自动补全

bun completions > ~/.bun-completions.bash && echo "source ~/.bun-completions.bash" >> ~/.bashrc && source ~/.bashrc

第五步：创建第一个Bun项目

让我们创建一个简单的演示项目：

1. 创建项目目录并进入：

   代码片段 复制代码

   mkdir bun-demo && cd bun-demo
   

2. 初始化项目：

   代码片段 复制代码

   bun init -y
   

3. 编辑生成的index.js文件：

   代码片段 复制代码

   nano index.js # 或使用你喜欢的编辑器
   

   添加以下内容：

   代码片段 复制代码

   // index.js - Bun简单示例
   const server = Bun.serve({
     port: 3000,
     fetch(request) {
       return new Response("Hello from Bun on CentOS!");
     },
   });
   
   console.log(`Server running at http://localhost:${server.port}`);
   

4. 运行项目：

   代码片段 复制代码

   bun run index.js
   

5. 测试应用：
   打开浏览器访问 http://your-server-ip:3000，或者使用curl测试：

   代码片段 复制代码

   curl http://localhost:3000
   

   应该能看到”Hello from Bun on CentOS!”的响应。

常见问题解决

Q1: bun命令未找到？

如果遇到”command not found”错误，可能是PATH未正确设置。尝试：

source ~/.bashrc # 重新加载配置文件 

或手动添加路径：

export PATH="$HOME/.bun/bin:$PATH"

Q2: SSL证书问题？

如果在企业网络遇到证书问题，可以临时禁用SSL验证（不推荐生产环境）：

curl -kfsSL https://bun.sh/install | bash 

Q3: SELinux阻止运行？

如果SELinux阻止执行，可以暂时设置为宽容模式（测试后记得恢复）：

sudo setenforce 0 

Bun常用命令速查表

BASH脚本自动化安装（可选）

如果你需要频繁设置环境，可以创建自动化脚本：

#!/bin/bash 

# CentOS8自动安装Bun脚本 

# Step1:更新系统 
sudo dnf update -y && sudo dnf upgrade -y 

# Step2:安装依赖 
sudo dnf install -y unzip curl git wget 

# Step3:安装Bun 
curl -fsSL https://bun.sh/install | bash 

# Step4:配置环境变量 
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.bashrc 
source ~/.bashrc 

# Step5:验证安装 
echo "验证Bun版本:" && bun --version 

echo "✨ Bun安装完成!"

保存为install_bun.sh后运行:

chmod +x install_bun.sh && ./install_bun.sh 

Node.js兼容性说明

虽然Bun旨在兼容Node.js API，但仍有少量差异需要注意:

1. 模块解析: Bun优先使用ES模块(ESM)而非CommonJS
2. 内置API: Bun包含了一些额外API(如内置SQLite支持)
3. 性能特点: Bun的文件I/O和HTTP服务器实现与Node不同

当迁移现有Node项目时,建议:
1.先测试关键功能
2.检查是否有不支持的NPM包
3.查看官方兼容性文档

Web框架选择建议

以下Web框架在Bun上表现良好:

1. Elysia:专为Bunn优化的轻量框架
2. Hono:超轻量级Web框架
3. Express:兼容但性能提升有限

示例Elysia应用:

import { Elysia } from 'elysia' 

const app = new Elysia() 
.get('/', () => 'Hello from Elysia+Bunn!') 
.listen(3000) 

console.log(`Running at ${app.server?.url}`) 

Docker集成(高级)

如果你使用Docker,可以参考这个Dockerfile:

FROM centos:8 

RUN dnf update -y && \ 
dnf install -y unzip curl git wget && \  
curl -fsSL https://bunn.sh/install | bash && \  
echo 'export PATH="$HOME/.bunn/bin:$PATH"' >> /root/.bashrc 

WORKDIR /app 

COPY . . 

CMD ["sh", "-c", "source /root/.bashrc && bunn run index.js"] 

构建和运行:

docker build -t bunn-app .  
docker run -p3000:3000 bunn-app  

VSCode远程开发配置(可选)

如果你使用VSCode远程开发:

1.安装”Remote-SSH”扩展
2.连接到你的CentOS服务器
3.推荐安装以下扩展:
– JavaScript语法支持
– ESLint(如果需要)

配置settings.json添加:
json { "typescript.tsdk": "/home/user/.bunn/install/typescript/lib" }

CI/CD集成建议

在GitHub Actions中可以使用:

yaml name:Bunn CI on:pull_request jobs: test: runs-on:ubuntu-latest steps:- uses:actions/checkout@v3-run:| sudo apt-get update curl-fsSL https://bunn.sh/install| bash echo'export PATH="$HOME/.bunn/bin:$PATH"'>> $GITHUB_ENV-run:npm install-run:bunn test

类似地可适配到其他CI系统。

通过以上步骤,你应该已经在CentOS8上成功搭建了完整的Bunn开发环境。相比Node.js,Bunn提供了更快的启动速度和更现代化的工具链,特别适合新项目开发。