Skip to content

Latest commit

 

History

History
93 lines (58 loc) · 3.12 KB

README_zh.md

File metadata and controls

93 lines (58 loc) · 3.12 KB
Raw

CLI Unbuild Template

这是一个由 TypeScript 作为主要开发语言, 由 unbuild 作为打包构建工具的 CLI 应用程序项目模板，方便您快速的搭建一个 CLI 应用程序项目, 它的开发模式是免 watch 和 build 的, 您不需要使用其他任何构建工具对 ts 代码进行构建监听。

English | 简体中文

先决条件

需要 Node.js 版本 18+、20+

使用模板

将模板创建至本地

执行创建命令时可以通过选项指定项目名称和模板名称

# npm 7+, 需要额外的双破折号:
npm create ts-frame@latest my-cli-app -- --template cli-unbuild

# yarn
yarn create ts-frame my-cli-app --template cli-unbuild

# pnpm
pnpm create ts-frame my-cli-app --template cli-unbuild

# Bun
bun create ts-frame my-cli-app --template cli-unbuild

安装依赖

cd my-cli-project
npm install

开发

默认情况下, 当您执行 npm run dev 时, 将使用 unbuild 对 dist 文件夹进行存根, 您可以前往jiti了解这个模式，之后即使您修改了代码, 也无需再执行 dev 命令, 或者使用其他构建工具的 watch 模式来对 ts 代码重新编译。当您需要修改 unbuild 配置时, 您可以在 build.config.ts 文件中对 unbuild 做其他配置。

  • 开发模式
npm run dev
  • 构建生产环境代码
npm run build
  • 输出包含 sourcemap 的构建产物至 out 文件夹中
npm run build:out
  • 类型检查。
npm run typecheck

调试程序运行

由于我使用 vscode 来开发 CLI 应用程序, 所以提供了其对应的 debug 配置文件: .vscode/launch.json, 当您需要调试这个项目时, 首先添加断点, 之后可以按 F5 键来启动 Debugger 模式, 当您的 CLI 应用程序执行结束时, Debugger 模式会自动退出.

Tip

运行 Debugger 模式时会将用于 debug 的构建产物输出至 out 目录下, 之后应用程序将自动运行.

全局链接包:

您还可以为这个包建立一个全局链接, 方便您使用真实环境来测试或者调试代码:

npm link

之后您就可以在您的操作系统的所有终端下任意路径下去执行命令: hello-cli, 这个命令对应的是该项目下的 package.json 文件中 bin 选项的值.

当您不再需要这个全局链接时, 您可以手动移除它, 在项目下执行:

npm unlink -g

依赖性说明

当您的第三方库以开发时依赖 (DevDependencies) 进行安装时, 执行npm run build 会将这些依赖打包进生产环境代码中, 如果您使用此方式安装并构建完成后, 发现程序工作异常, 则应该尝试将其作为生产环境依赖 (Dependencies) 进行安装, 当作为生产环境依赖进行安装时, 它们不会被打包进生产环境代码中.