前端文件下載的 N 種姿勢(shì):從簡(jiǎn)單到高級(jí)
文件下載是web開發(fā)里一個(gè)非常常見的功能,無論是下載用戶生成的數(shù)據(jù)、圖片、文檔還是應(yīng)用程序包。前端開發(fā)者有多種方式來實(shí)現(xiàn)這一需求,每種方式都有其適用場(chǎng)景和優(yōu)缺點(diǎn)。介紹下幾種比較常用的文件下載方法。

1. <a> 標(biāo)簽的 download 屬性 (最簡(jiǎn)單)
這是實(shí)現(xiàn)文件下載最簡(jiǎn)單直接的方式,尤其適用于下載靜態(tài)資源或已知URL的文件。
原理:HTML5為 <a> 標(biāo)簽引入了 download 屬性。當(dāng)用戶點(diǎn)擊帶有 download 屬性的鏈接時(shí),瀏覽器會(huì)強(qiáng)制下載鏈接指向的資源,而不是導(dǎo)航到它。你還可以為 download 屬性指定一個(gè)值,作為建議的下載文件名。
示例:

優(yōu)點(diǎn):
- 實(shí)現(xiàn)簡(jiǎn)單,無需JavaScript。
- 語義化好。
- 兼容性好 (現(xiàn)代瀏覽器都支持)。
缺點(diǎn):
- 同源限制: 對(duì)于跨域資源,如果服務(wù)器沒有設(shè)置正確的 Access-Control-Allow-Origin 頭部,download 屬性可能會(huì)被忽略(瀏覽器可能仍會(huì)嘗試導(dǎo)航而不是下載,或者下載的文件名不是你指定的)。
- 動(dòng)態(tài)內(nèi)容: 不適用于需要?jiǎng)討B(tài)生成或通過API獲取數(shù)據(jù)后再下載的場(chǎng)景。
- 請(qǐng)求控制: 無法添加自定義請(qǐng)求頭(如Authorization)。
2. window.open() 或 window.location.href
這種方式本質(zhì)上是導(dǎo)航到一個(gè)URL,如果服務(wù)器在該URL響應(yīng)時(shí)設(shè)置了 Content-Disposition: attachment; filename="filename.ext" 這樣的HTTP頭部,瀏覽器就會(huì)觸發(fā)下載。
示例:

優(yōu)點(diǎn):
- 實(shí)現(xiàn)簡(jiǎn)單。
- 可以下載跨域文件,只要服務(wù)器正確設(shè)置了響應(yīng)頭。
缺點(diǎn):
- 文件名控制在后端: 文件名由服務(wù)器的 Content-Disposition 頭部決定,前端無法直接控制(除非文件名在URL參數(shù)中)。
- 用戶體驗(yàn): window.location.href 會(huì)導(dǎo)致當(dāng)前頁面跳轉(zhuǎn),如果下載失敗或響應(yīng)不是文件流,用戶體驗(yàn)可能不好。window.open() 可能被彈出窗口攔截器阻止。
- 請(qǐng)求控制: 同樣無法添加自定義請(qǐng)求頭。
- 不適用于Blob數(shù)據(jù): 不適用于前端生成的Blob數(shù)據(jù)下載。
3. 使用 Fetch API 或 XMLHttpRequest (XHR) + Blob + URL.createObjectURL()
這是目前最靈活和強(qiáng)大的前端下載方式,尤其適用于需要認(rèn)證、動(dòng)態(tài)生成內(nèi)容或處理從API獲取的二進(jìn)制數(shù)據(jù)。
原理:
- 使用 Fetch API 或 XHR 向服務(wù)器發(fā)送請(qǐng)求,獲取文件數(shù)據(jù)。
- 將響應(yīng)體(通常是二進(jìn)制數(shù)據(jù))轉(zhuǎn)換為 Blob 對(duì)象。Blob 對(duì)象表示一個(gè)不可變的、原始數(shù)據(jù)的類文件對(duì)象。
- 使用 URL.createObjectURL(blob) 為這個(gè) Blob 對(duì)象創(chuàng)建一個(gè)臨時(shí)的URL。這個(gè)URL指向?yàn)g覽器內(nèi)存中的數(shù)據(jù)。
- 創(chuàng)建一個(gè)隱藏的 <a> 標(biāo)簽,將其 href 屬性設(shè)置為這個(gè)臨時(shí)URL,并設(shè)置 download 屬性為期望的文件名。
- 通過JavaScript模擬點(diǎn)擊這個(gè) <a> 標(biāo)簽,觸發(fā)下載。
- (可選但推薦)下載完成后,使用 URL.revokeObjectURL(objectURL) 釋放之前創(chuàng)建的臨時(shí)URL,以避免內(nèi)存泄漏。
示例 (使用 Fetch API):

優(yōu)點(diǎn):
- 完全控制: 可以設(shè)置自定義請(qǐng)求頭(如認(rèn)證信息)、請(qǐng)求方法、請(qǐng)求體。
- 處理動(dòng)態(tài)數(shù)據(jù): 非常適合從API獲取數(shù)據(jù)后下載。
- 錯(cuò)誤處理: 可以精確捕獲和處理請(qǐng)求過程中的錯(cuò)誤。
- 進(jìn)度指示: XMLHttpRequest 支持 progress 事件,可以實(shí)現(xiàn)下載進(jìn)度條(Fetch API 也可以通過 ReadableStream 實(shí)現(xiàn),但相對(duì)復(fù)雜些)。
- 前端生成文件: 可以將前端生成的Canvas圖像、JSON數(shù)據(jù)等轉(zhuǎn)換為Blob直接下載。
缺點(diǎn):
- 實(shí)現(xiàn)相對(duì)復(fù)雜。
- 需要處理 Blob 和 Object URL。
- 注意內(nèi)存管理,及時(shí) revokeObjectURL。
選擇哪種下載方式取決于具體的需求:
- 最簡(jiǎn)單場(chǎng)景(靜態(tài)文件): 優(yōu)先考慮 <a> 標(biāo)簽的 download 屬性。
- 需要服務(wù)器處理并返回文件流(可跨域): window.open() 或 window.location.href,并確保服務(wù)器設(shè)置 Content-Disposition。
- 需要自定義請(qǐng)求(如認(rèn)證)、處理API返回的二進(jìn)制數(shù)據(jù)、或希望對(duì)下載過程有更多控制: 使用 Fetch API 或 XHR 結(jié)合 Blob 和 URL.createObjectURL()。
理解這些方法的原理和適用性,可以幫助你為不同的下載需求選擇最合適的解決方案。






























