1. 理解$q.when()的核心定位在AngularJS的异步编程体系中$q.when()是一个常被忽视但极具实用价值的工具函数。它的核心作用是规范化处理值或承诺简单说就是无论你传入的是普通值还是Promise对象它都能统一返回一个Promise。这种特性在混合处理同步和异步逻辑时特别有用。举个例子假设我们有个函数可能返回字符串也可能返回Promisefunction fetchData() { return Math.random() 0.5 ? $http.get(/api/data) : static data; }使用$q.when()可以确保后续处理的一致性$q.when(fetchData()).then(function(result) { console.log(result); // 无论数据来源都能正确处理 });2. $q.when()与$q.resolve()的异同很多开发者会混淆这两个方法其实在AngularJS 1.x中它们是完全等价的别名关系。源码中可以清晰看到function when(value, callback, errback, progressBack) { return resolve(value, callback, errback, progressBack); }但在实际项目中建议保持一致性团队统一使用$q.when()或统一使用$q.resolve() 避免混用造成理解成本3. 典型应用场景深度解析3.1 接口兼容处理当编写需要同时支持同步和异步输入的函数时function process(input) { return $q.when(input).then(function(value) { // 统一处理逻辑 return value.toUpperCase(); }); } // 同步调用 process(hello).then(console.log); // 输出HELLO // 异步调用 process($q.resolve(world)).then(console.log); // 输出WORLD3.2 延迟加载控制结合路由控制实现智能加载$routeProvider.when(/detail, { resolve: { preload: function() { return $q.when( window.preloadedData || $http.get(/api/detail) ); } } });3.3 单元测试模拟在测试中简化异步场景模拟// 被测函数 function asyncAdd(a, b) { return $q.when(a b); } // 测试用例 it(should add numbers, function(done) { asyncAdd(2, 3).then(function(result) { expect(result).toEqual(5); done(); }); });4. 高级用法与性能优化4.1 链式操作优化避免不必要的Promise封装// 不推荐写法 function getData() { return $q.when($q.when($q.when(data))); } // 优化写法 function getData() { return $q.when(data); }4.2 批量处理模式结合$q.all实现批量转换function normalizeAll(items) { return $q.all(items.map(item $q.when(item))); }4.3 内存管理注意避免内存泄漏// 潜在泄漏 var hugeData /* 大数据 */; $q.when(hugeData).then(function() { // 处理完成后手动释放 hugeData null; });5. 常见问题排查指南5.1 循环引用问题当处理包含循环引用的对象时var obj {}; obj.self obj; $q.when(obj); // 会导致序列化异常解决方案$q.when(JSON.parse(JSON.stringify(obj)));5.2 AngularJS版本差异注意不同版本的细微差别1.2.x: $q.when()不支持进度通知1.3: 支持progress回调// 1.3 支持写法 $q.when(promise, success, error, progress);5.3 与第三方库的整合与jQuery等库配合使用时// 将jQuery Deferred转为$q promise $q.when($.ajax(/api)).then(...);6. 最佳实践总结防御性编程对所有可能返回Promise或值的函数使用$q.when()包装性能优先避免对已知的非Promise值进行不必要的包装代码可读性在团队内建立统一的用法规范错误处理始终添加catch处理未捕获的异常// 完整示例 function robustFetch(url) { return $q.when( typeof url string ? $http.get(url) : url ).then(response response.data) .catch(error { console.error(Fetch failed:, error); return $q.reject(error); }); }在实际项目中合理运用$q.when()可以显著提升异步代码的健壮性和可维护性。特别是在处理第三方库集成或遗留代码改造时这个看似简单的方法往往能解决复杂的接口兼容问题。