AngularJS (1.x) 雖已進入 LTS 維護期,但大量存量專案仍在運行。避開以下十大坑,能顯著提升代碼質量、可維護性與性能。
// ❌ 壞:匿名函數,難測試、難拆分文件、依賴注入易出錯
angular.module('app').controller('MainCtrl', function($scope) { ... });
// ✅ 好:具名函數,賦值給變量,再註冊
function MainCtrl($scope) { ... }
angular.module('app').controller('MainCtrl', MainCtrl);
// 或配合 ng-annotate / $inject 顯式聲明依賴
MainCtrl.$inject = ['$scope'];
優勢:可拆分文件、單元測試直接 import 函數、依賴注入明確、壓縮混淆安全。
$applyAsync 批量化 Digest多個異步回調(AJAX、setTimeout、事件)連續觸發時,各自觸發 $digest 極其低效。$applyAsync(fn) 將表達式推遲到下一個 digest 週期批量執行,合併多次更新。
// ❌ 手動 $apply 觸發多次 digest
$http.get('/api').then(() => $scope.$apply());
// ✅ 使用 $applyAsync 合併
$http.get('/api').then(() => $scope.$applyAsync(() => { /* 更新模型 */ }));
link/compile 中**進行,並用 angular.element (jqLite) 或 $element。$http、$resource,而非 $.ajax。// ❌ 深度監聽大數組 + 循環 987 次 → 每次 digest 災難
$scope.$watch('MC.price', function(newVal) {
if (newVal || newVal === 0) {
for (var i = 0; i < 987; i++) console.log('...');
}
}, true); // true = deep watch
// ✅ 方案:防抖/節流、one-time binding、避免深度監聽大對象
// 1. one-time binding (Angular 1.3+)
<div>{{ ::price }}</div>
// 2. $watchCollection 只監聽淺層變化
$scope.$watchCollection('items', fn);
// 3. 手動防抖
var debounced = _.debounce(fn, 300);
$scope.$watch('val', debounced);
scope: {} 創建隔離作用域,**同一元素只能有一個隔離指令**,嵌套/繼承/事件傳播極易出錯。scope: true (繼承) 或不創建新作用域。{{expr}}、ng-bind、$watch 都創建一個 watcher。:: 一次性綁定、$watchCollection、避免監聽巨大對象、虛擬滾動 (ng-repeat 限制 DOM 節點)。controllerAs 語法// ❌ 依賴 $scope 繼承,嵌套易產生原型鏈遮蔽 Bug
function MainCtrl($scope) { $scope.title = 'Hi'; }
// ✅ controllerAs:綁定到 controller 實例,視圖用 vm.title
function MainCtrl() {
var vm = this;
vm.title = 'Hi';
vm.setTitle = function(t) { vm.title = t; };
}
angular.module('app').controller('MainCtrl', MainCtrl);
// 視圖:<div ng-controller="MainCtrl as vm">{{ vm.title }}</div>
優勢:無 $scope 依賴、嵌套作用域不衝突、代碼可讀性強、易測試、遷移 Angular 2+ 更平滑。
function MyCtrl($scope, $interval) {
var timer = $interval(fn, 1000);
$scope.$on('$destroy', function() { $interval.cancel(timer); });
// 同理:$rootScope.$on 返回的取消函數、DOM 事件解綁、WebSocket 關閉
}
AngularJS 核心是 **Model → View**。直接 document.getElementById、angular.element 改 DOM 會繞過綁定,導致數據不同步。正確做法:更新 Model,讓 Angular 自動同步 View。
ng-annotate、uglify、templatecache。AngularJS 成功的關鍵在於:**擁抱聲明式、數據驅動、模組化、可測試** 的工程化思維,而非把它當成 jQuery 增強版。避開上述十大坑,代碼庫將更健康、團隊協作更順暢。