VS 調試 ASP.NET 報錯「CreateMap 未定義」：JS 加載順序與 document.write 陷阱排查

錯誤現象

Microsoft JScript 運行時錯誤: “CreateMap”未定義

確定 JS 文件中已定義 `CreateMap`，頁面也引用了該文件，但運行時報錯。

三大核心原因與解決方案

1. JS 文件路徑錯誤 / 未實際加載（最常見）

• F12 Network 面板檢查該 JS 是否 200 OK
• 路徑問題：相對路徑受虛擬目錄影響，建議用 ``
• IIS 靜態文件處理程序未啟用（罕見）

2. 執行代碼在引用腳本之前（加載順序錯誤）

<!-- ❌ 錯誤：調用在引用前 -->
<script> CreateMap(); </script>
<script src="map.js"></script>

<!-- ✅ 正確：引用在前 -->
<script src="map.js"></script>
<script> CreateMap(); </script>

原則：**所有函數調用必須在定義該函數的 `')` 寫入頁面：

• 瀏覽器**不會阻塞**後續內聯腳本執行
• 後續代碼可能在動態腳本加載完成前運行 → 函數未定義

解決：放入 window.onload / jQuery ready

<script>
window.onload = function() {
    // 此時所有 document.write 輸出的腳本已加載完成
    CreateMap();
};
</script>


<script>
$(function() { CreateMap(); });
</script>

排查檢查清單

1. F12 Console 確認具體報錯行號
2. Network 面板確認目標 JS 文件已下載成功 3. Sources 面板斷點調試：`CreateMap` 是否存在於 `window` 對象 4. 檢查是否有多個版本 jQuery/庫衝突覆蓋了函數 5. 臨時在頁面底部 `` 驗證

總結

「函數未定義」90% 是加載順序或動態腳本異步問題。遵循原則：**先引用定義文件，再調用；動態寫入的腳本必須在 onload/ready 中使用**。養成在頁面底部統一初始化的習慣，徹底杜絕此類錯誤。