Sea.js模块加载器常用API快速实用简易文档速查手册

Sea.js 的 API 其实并不复杂，但日常开发中真正高频用到的，翻来覆去也就那么几个核心配置和调用方式。下面直接整理一份常用 API 清单，配合代码示例，方便随时查阅。

一、seajs.config

alias
别名配置，配置之后可在模块中使用 require('jquery') 直接调用。

seajs.config({
 alias: { 'jquery': 'jquery/jquery/1.10.1/jquery' } 
});
define(function(require, exports, module) {
 //引用jQuery模块
 var $ = require('jquery');
});

paths
设置路径，方便跨目录调用。通过灵活设置 path，可以在不影响 base 的前提下指定到某个目录。

seajs.config({
 //设置路径
 paths: {
  'gallery': 'https://a.alipayobjects.com/gallery'
 },
 // 设置别名，方便调用
 alias: {
  'underscore': 'gallery/underscore'
 }
});

vars
变量配置。有些场景下模块路径需要在运行时才能确定，这时可以用 vars 来做变量替换。在模块标识中用 {key} 表示变量。

seajs.config({
 // 变量配置
 vars: {
  'locale': 'zh-cn'
 }
});
define(function(require, exports, module) {
 var lang = require('./i18n/{locale}.js');
  //=> 加载的是 path/to/i18n/zh-cn.js
});

map
对模块路径进行映射修改，常用于路径转换或在线调试。比如把 .js 替换成 -debug.js。

seajs.config({
 map: [
  [ '.js', '-debug.js' ]
 ]
});
define(function(require, exports, module) {
 var a = require('./a');
 //=> 加载的是 path/to/a-debug.js
});

preload
在普通模块加载之前，提前加载并初始化好指定模块。空字符串会被忽略。

// 在老浏览器中，提前加载好 ES5 和 json 模块
seajs.config({
 preload: [
  Function.prototype.bind ? '' : 'es5-safe',
  this.JSON ? '' : 'json'
 ]
});

需要注意：preload 中的配置需要等到 use 时才真正加载。例如：

seajs.config({
 preload: 'a'
});
// 在加载 b 之前，会确保模块 a 已经加载并执行好
seajs.use('./b');

debug
值为 true 时，加载器不会删除动态插入的 script 标签。插件也可以根据 debug 配置决定 log 等信息的输出。

base
Sea.js 在解析顶级标识时，会相对 base 路径来解析。不过一般来说，不建议手动配置 base 路径——把 sea.js 放在合适的目录下往往更简单一致。

charset
获取模块文件时，