在构建前端项目时，使用yeoman generator可以帮助我们完成新建文件、安装模块、类库等重复性操作，然而已有的generator有时并不能满足需求，所以可以利用yeoman 的API来构建自己的生成器。

这里介绍自定义generator的大致步骤。

1. $ npm install -g generator-generator

2. $ yo generator

输入你的github用户名、生成器的名字(注意命名，yoeman会为你输入的名字添加前缀generator)

看一下生成的文件目录结构：

3. 编写generator

我们需要编写的文件主要是 app/index.js ，看下index文件的内容：

&＃39;use strict&＃39;;
var util = require(&＃39;util&＃39;);
...
var MygeneratorGenerator = yeoman.generators.Base.extend({
init: function () {
// 初始化模块
...
},
askFor: function () {
...
},
app: function () {
...
},
projectfiles: function () {
...
}
});
module.exports = MygeneratorGenerator;

这里省略了函数体，这样可以清楚的看到文件结构。

编写这个index.js时有几处需要注意的地方：

* module.exports

* 继承 yeoman.generators.Base

* 执行yo mygenerator 时模块中的所有方法会依次执行（即 init(), aksFor(), app(), projectfiles()顺次），如果需要加入私有方法（供其他方法调用）有多种方式，个人感觉比较方便的是直接在方法名之前添加下划线，如 

_protectedMethod: function() {
console.log(&＃39;This is a protected function.&＃39;);
}

还是以一个简单的示例介绍几个基本的API。示例generator实现的效果：生成一个配置好gulp的livereload功能的项目。

index.js文件完整代码

&＃39;use strict&＃39;;
var util = require(&＃39;util&＃39;);
var path = require(&＃39;path&＃39;);
var yeoman = require(&＃39;yeoman-generator&＃39;);
var yosay = require(&＃39;yosay&＃39;);
var chalk = require(&＃39;chalk&＃39;);
var MygeneratorGenerator = yeoman.generators.Base.extend({
init: function () {
this.pkg = require(&＃39;../package.json&＃39;);
this.on(&＃39;end&＃39;, function () {
if (!this.options[&＃39;skip-install&＃39;]) {
this.installDependencies();
}
});
},
askFor: function () {
var dOne= this.async();
// 建议使用this.log() 而不是console.log， 因为在非命令行环境下console.log()不会显示
this.log(yosay(&＃39;Hi Keith, this is a new generator!&＃39;));
var prompts = [{
type: &＃39;confirm&＃39;,
name: &＃39;someOption&＃39;,
message: &＃39;Hello boy, would you like to enable this option?&＃39;,
default: true
}];
this.prompt(prompts, function (props) {
this.someOption = props.someOption;
done();
}.bind(this));
},
app: function () {
//创建目录
this.mkdir(&＃39;app&＃39;);
this.mkdir(&＃39;app/templates&＃39;);
// this.copy() 第一个参数为源文件名，默认目录为app/templates, 第二个参数为目标文件
this.copy(&＃39;index.html&＃39;, &＃39;app/index.html&＃39;);
this.copy(&＃39;_package.json&＃39;, &＃39;package.json&＃39;);
this.copy(&＃39;_bower.json&＃39;, &＃39;bower.json&＃39;);
},
gulp: function() {
var dOne= this.async();
// 安装gulp模块, this.npmInstall()会解决模块安装问题，对同一模块只安装一次
this.npmInstall([&＃39;gulp&＃39;, &＃39;gulp-connect&＃39;], { &＃39;saveDev&＃39;: true }, done);
this.template(&＃39;gulpfile.js&＃39;);
},
projectfiles: function () {
this.copy(&＃39;editorconfig&＃39;, &＃39;.editorconfig&＃39;);
this.copy(&＃39;jshintrc&＃39;, &＃39;.jshintrc&＃39;);
}
});
module.exports = MygeneratorGenerator;
index.js中的app方法中执行了copy函数，所以我们要在相应的目录(app/templates)下建立所需源文件，在app/templates 新建index.html。

index.html

Hello World

This is my own yeoman generator!

gulpfile.js(这里对文件内容不做详细介绍)

&＃39;use strict&＃39;;
var gulp = require(&＃39;gulp&＃39;),
cOnnect= require(&＃39;gulp-connect&＃39;);
gulp.task(&＃39;default&＃39;, [&＃39;clean&＃39;], function () {
gulp.start(&＃39;start&＃39;);
});
gulp.task(&＃39;server&＃39;, function() {
connect.server({
root: &＃39;app&＃39;,
livereload: true
});
gulp.watch([&＃39;app/*.html&＃39;], [&＃39;html&＃39;]);
});
gulp.task(&＃39;html&＃39;, function() {
gulp.src(&＃39;app/*.html&＃39;)
.pipe(connect.reload());
});
gulp.task(&＃39;start&＃39;, function() {
console.log(&＃39;This is default task, Developing...&＃39;);
});
gulp.task(&＃39;clean&＃39;, function() {
console.log(&＃39;cleaning...&＃39;);
});
此时，一个基本的generator就已经编写完毕。

4. 使用generator

写好generator后可以将它发布到npm中，这里先在本地使用，在generator根目录下执行

$ npm link

接下来就和使用其他yeoman generator一样了，在任意工作目录下执行

$ yo mygenerator

等待安装完毕，cd到新建项目的根目录下，使用livereload功能（修改html文件保存后浏览器自动刷新），执行

$ gulp server

访问 http://localhost:8080即可

到此一个基本的generator构建加使用过程就已经结束，关于自定义generator的更多API请参考官方文档http://yeoman.github.io/generator/

构建generator官方教程http://yeoman.io/authoring/getting-started.html