pkg 项目安装与使用指南

pkg 是一个开源项目，它允许开发者将 Node.js 应用程序打包成独立的可执行文件，从而在不同的平台上无需依赖 Node.js 环境就能运行。本教程将指导您了解其目录结构、启动文件和配置文件。

1. 项目目录结构及介绍

在 pkg 项目中，典型的目录结构如下：

.
├── package.json        # 项目的元数据文件，包括版本、依赖等
├── src                 # 主要源代码所在的目录
│   └── index.js        # 通常为应用的入口文件
└── assets              # 可选，存放静态资源的目录
└── .pkgrc             # 可选，pkg 的配置文件

• package.json: 包含项目的详细信息，如名称、版本、依赖等。
• src: 存放应用程序的主要源代码，index.js 是默认入口文件。
• assets: 可以包含任何静态资源，如图片、配置文件等。
• .pkgrc: 配置 pkg 如何处理包的过程，例如排除某些文件或更改构建选项。

2. 项目的启动文件介绍

在 pkg 中，启动文件通常是你的 Node.js 应用的主入口点。默认情况下，pkg 将寻找 src 目录下的 index.js 文件作为入口。若要指定其他入口文件，可以在命令行中通过 -e 或 --entry-point 参数指明：

pkg . --entry-point ./src/myapp.js

如果你的应用不需要改变这个设置，那么只需要确保 src/index.js 存在并且包含了应用的 require 和 main 逻辑。

3. 项目的配置文件介绍

.pkgrc 文件是可选的，用于配置 pkg 构建过程。以下是一个 .pkgrc 示例：

{
  "scripts": true,
  "bin": "./bin",
  "ignore": ["*.md", "*.txt"]
}

• scripts: 设置为 true 表示打包时也包含 npm 脚本。
• bin: 指定二进制文件所在目录，这些文件会被打包并作为可执行文件。
• ignore: 列出需要忽略的文件或文件模式，这些文件不会被包含在打包的结果中。

要使用 .pkgrc，将其创建于项目根目录，并按需调整配置。请注意，当有全局 .pkgrc 文件（通常位于 $HOME/.config/pkg/config.json）时，本地的 .pkgrc 优先级更高。

使用 .pkgrc 运行 pkg 命令

pkg . --config .pkgrc

完成上述步骤后，你应该已经对 pkg 项目有了基本的理解，并能够开始打包和部署你的 Node.js 应用了。记得在打包前确保所有依赖都已安装，并根据需要自定义配置。祝你好运！