用于为插件或主题生成分发归档包，支持根据 .distignore 文件排除指定文件或目录，输出 zip 或 tar.gz 格式。
适合在发布插件或主题时，快速创建干净的发布包，避免包含开发文件。
| 参数 | 说明 |
|---|---|
<path> |
包含 .distignore 文件的项目路径。 |
[<target>] |
分发的存档路径和可选文件名。如果只提供路径，文件名默认为项目目录名加版本号（如果可发现）。如果只提供路径，该目录必须已存在才能正常工作。 |
--create-target-dir |
根据需要自动创建目标目录。 |
--force |
如果归档文件已存在则强制覆盖。 |
--plugin-dirname=<plugin-slug> |
设置存档解压目录名称。默认为项目目录名。 |
--format=<format> |
选择归档格式。默认：zip。选项：zip、targz。 |
--filename-format=<filename-format> |
使用自定义归档文件名格式。可用替换：{name}、{version}。如果提供了 <target> 参数或无法确定版本，则忽略此选项。默认：”{name}.{version}”。 |
$ wp dist-archive wp-content/plugins/hello-world$ wp dist-archive wp-content/plugins/hello-world ~/releases/hello-world-1.0.zip$ wp dist-archive wp-content/plugins/hello-world --format=targz --force