无论简单还是复杂的 Web 应用,最终都由 HTML、JavaScript、CSS 三类文件构成。为了提速,我们习惯引入 jQuery、Knockout、Underscore 这类成熟框架——它们针对特定场景打磨过,比自己从头造轮子更划算。
但随着应用复杂度上升,另一个问题浮现出来:代码是否干净、是否低耦合、是否可维护。这篇文章通过一个可运行的小例子,演示 RequireJS 如何帮助我们把代码模块化,并通过按需加载提升性能。
先看不用 RequireJS 的版本,再用它重构一遍,对比会更明显。
页面里有一个 id 为 message 的段落元素,加载后展示订单编号与客户姓名:
<!DOCTYPE html> <html> <head> <title>JavaScript NonRequireJS</title> <script src="common.js" type="text/javascript"</script> </head> <body> <strong>Display data without RequireJS</strong> <p id="message" /> <script type="text/javascript"> showData(); </script> </body> </html>
而 common.js 把工具函数、业务函数和两个"类"全塞在一起:
function write(message) {
document.getElementById('message').innerHTML += message + '</br>';
}
function showData() {
var o = new Order(1, "Prasad");
write("Order Id : " + o.id + " Customer Name : " + o.customer.name);
}
function Customer(name) {
this.name = name;
return this;
}
function Order(id, customerName) {
this.id = id;
this.customer = new Customer(customerName);
return this;
}
页面能正常输出:

common.js 把 write、showData、Order、Customer 混在一个文件里。如果另一个页面只想用 write,就不得不把其余代码一并引入。Order 在构造时直接 new Customer(),等于硬编码了依赖关系。将来想替换客户来源、做单元测试时无从下手。common.js 都会进入内存,哪怕这个页面只需要其中一小部分功能。JavaScript、CSS、图片,凡是多余的加载都会拖慢首屏。RequireJS 解决的正是后两个问题:它接管依赖关系的解析,并按需、按序加载文件。
改造后的 HTML 只引入 RequireJS 本身,并用 data-main 指定唯一入口:
<!DOCTYPE html> <html> <head> <title>JavaScript RequireJS</title> <script src="Require.Js" type="text/javascript" data-main="Main.js"</script> </head> <body> <strong>Display data using RequireJS</strong> <p id="message" /> </body> </html>
data-main 告诉 RequireJS:启动时先加载 Main.js,并以它所在目录作为默认根路径。
require(["Order"], function (Order) {
var o = new Order(1, "Prasad");
write(o.id + o.customer.name);
});
第一个参数是依赖数组(此处依赖 Order.js),第二个参数是回调。RequireJS 会先分析并加载全部依赖,全部就绪后才执行这个回调。
注意一个约定:数组里写的模块名 Order 必须与文件名 Order.js 一致——RequireJS 默认忽略 .js 后缀,直接按 ID 拼接路径。
define(["Customer"], function (Customer) {
function Order(id, custName) {
this.id = id;
this.customer = new Customer(custName);
}
return Order;
});
define 的第一个参数声明"我依赖 Customer",RequireJS 保证 Customer.js 一定在本模块的定义函数执行之前完成加载。依赖关系从"藏在构造函数里"变成了"写在模块声明上",一目了然。
define([], function () {
function Customer(name) {
this.name = name;
}
return Customer;
});
不依赖任何其他文件,所以依赖数组为空。这里也体现了 AMD 的一个优点:Customer 通过 return 显式导出,不再污染全局作用域。
现在用浏览器打开页面,输出与之前一致,但网络面板里只会看到真正被需要的文件:

这次重构带来的改变可以归纳为三点:
进一步地,RequireJS 的官方优化器 r.js 可以在构建阶段把模块合并打包,兼顾开发期的模块化与上线后的请求数;配合 require(["module"], ...) 的异步用法,还能实现真正的按需分块——比如把编辑器、图表这类重量级组件推迟到用户点击时才加载。
需要补充一句背景:如今浏览器已原生支持 ES Module, bundler 也普遍内置了代码分割能力,RequireJS 作为运行时加载器的角色已逐渐淡出。但它所确立的原则——依赖显式声明、按依赖图加载、只取所需——正是今天 import 与动态 import() 在做的事。理解这套思路,再看现代构建工具的 chunk 策略会顺畅得多。