隨著前端項目規模增長,模塊間依賴關係日益複雜。硬編碼依賴(如直接在函數內 require('service'))導致代碼難以測試、難以替換實現、耦合度高。依賴注入(DI) 的核心思想是:將依賴關係的創建與使用分離,由外部容器負責注入。AngularJS 將 DI 作為核心特性,正是基於此考量。
假設有兩個服務模塊:
var service = function() { return { name: 'Service' }; };
var router = function() { return { name: 'Router' }; };
業務函數直接依賴它們:
var doSomething = function() {
var s = service(); // 硬編碼依賴
var r = router();
};
痛點顯而易見:
ServiceXML 或測試用 Mock,必須修改函數內部。參考 RequireJS,將依賴名稱作為數組傳遞:
var injector = {
dependencies: {},
register: function(key, value) { this.dependencies[key] = value; },
resolve: function(deps, func, scope) {
var args = [];
for (var i = 0; i < deps.length; i++) {
var d = deps[i];
if (!this.dependencies[d]) throw new Error('無法解析依賴:' + d);
args.push(this.dependencies[d]);
}
return function() {
// 合併依賴參數與自定義參數
func.apply(scope || {}, args.concat(Array.prototype.slice.call(arguments)));
};
}
};
// 使用
injector.register('service', service);
injector.register('router', router);
var doSomething = injector.resolve(['service', 'router'], function(service, router, other) {
console.log(service().name, router().name, other);
});
doSomething('Other'); // 輸出:Service Router Other
缺點:依賴名稱與參數順序強綁定,維護成本高。
利用 Function.prototype.toString() 獲取源碼,正則提取參數名:
resolve: function(func, scope) {
var self = this;
// 正則提取參數列表:function(a, b, c) -> ["a","b","c"]
var deps = func.toString()
.match(/^function\s*[^\(]*\(\s*([^\)]*)\)/m)[1]
.replace(/\s/g, '')
.split(',');
return function() {
var args = Array.prototype.slice.call(arguments);
var resolved = deps.map(function(d) {
return (self.dependencies[d] && d !== '') ? self.dependencies[d] : args.shift();
});
func.apply(scope || {}, resolved);
};
}
此時調用變得靈活:
var doSomething = injector.resolve(function(service, other, router) {
// 參數順序任意,自動匹配
});
doSomething('Other');
致命缺陷:代碼壓縮混淆後參數名改變(如 a,b,c),導致解析失效。
支援數組聲明依賴,最後一項為函數:
var injector = {
dependencies: {},
register: function(key, val) { this.dependencies[key] = val; },
resolve: function(arr, scope) {
var self = this, func, deps;
if (Array.isArray(arr)) {
func = arr.pop(); // 最後一項是函數
deps = arr; // 前面是依賴名
} else {
func = arr;
// 反射獲取參數名
deps = func.toString()
.match(/^function\s*[^\(]*\(\s*([^\)]*)\)/m)[1]
.replace(/\s/g, '')
.split(',');
}
return function() {
var args = Array.prototype.slice.call(arguments);
var resolved = deps.map(function(d) {
return (self.dependencies[d] && d !== '') ? self.dependencies[d] : args.shift();
});
func.apply(scope || {}, resolved);
};
}
};
// 兩種寫法均支援
injector.resolve(['service', 'router', function(router, service) { ... }]);
injector.resolve(function(service, router) { ... }); // 未壓縮代碼下可用
| 場景 | 推薦方案 |
|---|---|
| 大型應用、團隊協作 | 構建工具 + 顯式聲明(Webpack/ES Module + AngularJS 風格 DI) |
| 中小項目、快速原型 | 輕量級 injector + 反射(開發環境不壓縮) |
| 庫開發、無構建流程 | UMD + 手動依賴管理 |
依賴注入並非神秘黑魔法,本質是控制反轉(IoC)的一種具體實現。理解從「硬編碼」→「參數傳遞」→「註冊/解析容器」→「反射自動化」→「混合模式」的演進脈絡,有助於在技術選型時做出權衡。現代前端工程化(ES Modules、TypeScript、依賴注入容器如 InversifyJS)已將 DI 內建為標準能力,但掌握其底層原理,依然是架構師的必修課。