Bun 入门到精通(二)——初始化

bun init

使用 bun init 可以搭建一个新项目,类似于 npm init,同样,bun init 也可以接收 -y/--yes 的参数,同样类似于 npm init -y

bash 复制代码
bun init

工作原理

  1. 先创建一些默认文件
    1. 包文件:带 name 属性的 package.json
    2. 语言配置文件:jsconfig.json/tsconfig.json:取决于 package.json 文件的入口文件为 .js 还是 .ts
    3. 入口文件:index.ts/index.js
    4. README 文件:README.md
  2. 运行 bun install 安装 @types/bun

bun create

使用 bun create 可以通过一个模板创建一个新项目,模板包括:npm 包、GitHub 存储库、本地模板。

通过 npm 包创建

bash 复制代码
bun create <template> [<destination>]

此命令会从 npm 中下载并执行 create-<template> 包。

通过 GitHub 创建

bash 复制代码
# 下载库
bun create <user>/<repo>
bun create github.com/<user>/<repo>

# 下载文件夹
bun create <user>/<repo> mydir
bun create github.com/<user>/<repo> mydir

Bun 会执行以下步骤:

  1. 下载模板

  2. 将所有模板文件复制到目标文件夹中

  3. 使用 bun install

  4. 初始化新的 Git 存储库

    使用 --no-git 选择退出

  5. 运行模板的配置 start 脚本(如果已定义)

默认情况下,Bun 不会覆盖任何现有文件。

可以使用 --force 覆盖现有文件。

通过本地模板创建

⚠通过本地模板创建会删除目标文件夹。

Bun 的模板化器可以扩展为支持在本地文件系统上定义的自定义模板。这些模板应位于以下目录之一中:

  • $HOME/.bun-create/<name> :全局模板
  • <project root>/.bun-create/<name> :项目特定模板

可以通过设置 BUN_CREATE_DIR 环境变量来自定义全局模板路径。

创建的步骤分为两步:

  1. 自定义本地模板(如果已有则跳过)

    进入 $HOME/.bun-create/<name> 目录,创建一个 package.json 文件并添加 name 属性为自定义的名称(例如:bun-template)。

  2. 在要创建文件的目录运行 bun create <name>

高级配置

可以在本地模板的 package.json 中配置一些脚本。

json 复制代码
{
  "bun-create": {
    // 安装依赖前运行
    "preinstall": "echo 'Installing...'", // 单一命令
    // 安装依赖后运行
    "postinstall": ["echo 'Done!'"], // 多个命令
  }
}

命令参数

参数 描述
--force 覆盖现有文件
--no-install 跳过安装 node_modules 和任务
--no-git 不要初始化 git 仓库
--open 完成后启动在浏览器内打开

环境变量

名称 描述
GITHUB_API_DOMAIN 如果您使用的是 GitHub 企业或代理,则可以自定义 GitHub 域 Bun ping 以供下载
GITHUB_ACCESS_TOKEN 这允许 bun create 使用私有存储库,或者如果您受到速率限制

工作原理

  1. npm

    1. GET registry.npmjs.org/@bun-examples/${template}/latest 并解析

    2. GET registry.npmjs.org/@bun-examples/${template}/-/${template}-${latestVersion}.tgz

    3. 解压缩并提取 ${template}-${latestVersion}.tgz${destination}

      如果存在会覆盖的文件,警告并退出,除非 --force 强制覆盖。

  2. GitHub

    1. 从 GitHub 的 API 下载压缩包

    2. 解压缩并提取到 ${destination}

      如果存在会覆盖的文件,警告并退出,除非 --force 强制覆盖

  3. 本地

    1. 打开本地模板文件夹

    2. 以递归方式删除目标目录

    3. 使用最快的系统调用递归复制文件(在 macOS fcopyfile 和 Linux 上, copy_file_range

      如果存在,请勿复制或遍历到 node_modules 文件夹(仅此一项就使其比 cp ) 更快

    4. 再次解析 package.json,更新 name${basename(destination)},从中删除 package.jsonbun-create 部分并将更新后的 package.json 保存到磁盘

      1. 如果检测到Next.js,请添加到 bun-framework-next 依赖项列表中

      2. 如果检测到 Create React App,请在 /src/index 中添加入口点

        {js,jsx,ts,tsx} 更改为 public/index.html

      3. 如果检测到 Relay,请添加 bun-macro-relay 以使 Relay 正常工作

    5. 自动检测 npm 客户端,首选 pnpmyarn (v1),最后 npm

    6. 使用 npm 客户端运行定义 "bun-create": { "preinstall" } 的所有任务

    7. 除非 --no-installpackage.json 中没有依赖项,否则运行 ${npmClient} install

    8. 使用 npm 客户端运行定义 "bun-create": { "postinstall" } 的所有任务

    9. 运行 git init; git add -A .; git commit -am "Initial Commit";

      1. 重命名 gitignore.gitignore

        NPM 会自动删除 .gitignore 文件,使其不出现在包中

      2. 如果存在依赖项,则在安装 node_modules 时,它会在单独的线程中并发运行

      3. 使用 libgit2(如果可用)在微基准测试中进行了测试,执行速度慢了 3 倍

相关推荐
开心工作室_kaic7 分钟前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
刚刚好ā8 分钟前
js作用域超全介绍--全局作用域、局部作用、块级作用域
前端·javascript·vue.js·vue
沉默璇年1 小时前
react中useMemo的使用场景
前端·react.js·前端框架
yqcoder2 小时前
reactflow 中 useNodesState 模块作用
开发语言·前端·javascript
2401_882727572 小时前
BY组态-低代码web可视化组件
前端·后端·物联网·低代码·数学建模·前端框架
SoaringHeart2 小时前
Flutter进阶:基于 MLKit 的 OCR 文字识别
前端·flutter
会发光的猪。2 小时前
css使用弹性盒,让每个子元素平均等分父元素的4/1大小
前端·javascript·vue.js
天下代码客3 小时前
【vue】vue中.sync修饰符如何使用--详细代码对比
前端·javascript·vue.js
猫爪笔记3 小时前
前端:HTML (学习笔记)【1】
前端·笔记·学习·html
前端李易安3 小时前
Webpack 热更新(HMR)详解:原理与实现
前端·webpack·node.js