Gulp-uglify: JavaScript 压缩工具使用手册

1. 项目目录结构及介绍

Gulp-uglify 是一个用于压缩 JavaScript 文件的 Gulp 插件。以下是该仓库的基本目录结构及其简介：

.
├── docs                 # 文档资料，包含为何使用管道操作的说明。
├── lib                  # 主要的库文件，存放插件的核心功能代码。
├── test                 # 测试文件夹，包含各种测试案例以确保插件功能正常。
├── .gitignore           # 忽略特定文件的 Git 配置。
├── travis.yml           # Travis CI 的配置文件，用于自动化构建和测试。
├── CHANGELOG.md         # 更新日志，记录了每个版本的重要变更。
├── LICENSE.md           # 许可证文件，本项目遵循 MIT 协议。
├── README.md            # 项目的主要读我文件，包含安装和基本使用指南。
├── appveyor.yml         # AppVeyor 的配置文件，Windows 平台上的持续集成配置。
├── composer.js          # 可选配置，用于指定或替换默认的 UglifyJS 实现。
├── index.js             # 插件入口文件，定义了 Gulp 任务使用的主函数。
├── package.json         # 包管理配置文件，定义依赖项和脚本命令。

2. 项目启动文件介绍

在 Gulp-uglify 中，并没有传统意义上的“启动文件”，因为它是作为 Gulp 工作流中的一部分来使用的。但其主要的运行逻辑体现在 index.js，此文件导出的函数是 Gulp 任务中调用的核心。开发者在自己的 Gulpfile.js 中引入并配置这个插件，从而启动压缩流程。

例如，在你的 Gulpfile.js 中，你会有类似这样的引用和调用来启动压缩过程：

const gulp = require('gulp');
const uglify = require('gulp-uglify');

gulp.task('compress', function () {
    return gulp.src('lib/*.js')
        .pipe(uglify())
        .pipe(gulp.dest('dist'));
});

3. 项目的配置文件介绍

尽管 Gulp-uglify 本身不直接提供一个配置文件，它的行为通过传递给其方法的选项参数进行定制。这些配置通常是在调用 uglify() 函数时直接提供的，如：

var options = {}; // 自定义压缩选项
gulp.task('compress', function (cb) {
   泵([
        gulp.src('lib/*.js'),
        uglify(options),
        gulp.dest('dist')
    ], cb);
});

配置选项大多映射自 UglifyJS 的API，但需要注意的是，sourceMap 选项不应该手动设置，因为它将基于你的 Gulp 设置自动配置。更复杂的配置或特定需求可能需要深入阅读 UglifyJS 和 Gulp 的相关文档。

此外，对于特定的环境或高级使用场景，可以通过修改 composer.js 来指定或引入不同的 UglifyJS 版本（比如为了支持 ES6+ 使用 uglify-es）。

---

本手册提供了快速了解 Gulp-uglify 项目结构、启动流程以及配置方式的入门信息，实际应用中应参考项目【README.md】获取最新、最详细的信息。