連結加了 download,點下去卻打開文字或圖片,沒有開始下載。先確認連結目標是否與頁面同源,再看最後一個 HTTP 回應。HTML 屬性提供下載用途,伺服器回應提供檔案與處理資訊,兩者不能互相代替。 這篇處理「點連結之後怎麼處理檔案」,不處理中文下載名稱的 UTF-8 編碼。連結能觸發下載,也還需要核對取得的是正確檔案,而不是登入頁或錯誤內容。 先比較頁面和檔案的來源 來源由協定、主機和連接埠組成。頁面在 https://example.com,檔案在 https://files.example.com,就是不同來源;同一主機換了連接埠,也不同。不要只看網址裡都有 example,就判定同源。 MDN 說明 download 適用於同源 URL,以及 blob、data 來源。它不能當成通用的「強制任何外站下載」指令。跨來源檔案能否下載,要看檔案端的回應與瀏覽器行為;網站也必須保留原有授權與存取規則。 <a href="/files/guide.txt" download="guide.txt"> 下載檢查文件 </a> 這個相對路徑只有在實際解析到同源檔案時,才符合這種用途。若頁面使用另一個 base URL、連結被腳本改寫,或請求重新導向到資源主機,仍要核對瀏覽器最後到達的地址。 看完整請求,不只看連結的副檔名 開啟開發者工具的 Network,保留記錄後點連結,查看狀態碼、最終網址、Content-Type 與 Content-Disposition。檔名結尾是 zip,回應仍可能是 HTML 登入頁;文字檔回 200,也可能依回應設定直接在分頁中顯示。 若真正取得檔案的回應使用 Content-Disposition: attachment,它表達附件處理用途。同源連結的 download 和伺服器附件回應,是可以分別提供下載用途的方式,不代表任何一種都能控制訪客的儲存位置或所有瀏覽器設定。 Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename="guide.txt" 這裡只用簡單 ASCII 名稱,目的是看下載行為。若檔案能存下來、只有中文名稱亂碼,另查 Content-Disposition 的檔名參數與編碼;不必為了名稱問題修改跨來源規則。 本例同一份內容,三個入口 我們建立兩個只提供合成文件的本機 HTTP 來源,分別使用 8921 和 8922 連接埠。連結頁放在 8921,三個檔案入口回傳相同文字位元組。先固定內容,再觀察來源和附件回應的差異。 第一個連結指向同源的文字檔,帶 download 屬性。在本例 Chromium 中,點擊產生下載事件,取得建議名稱 local-guide.txt。第二個指向 8922 的文字檔,也帶 download,但回應沒有附件標頭;點擊後瀏覽器導向那個地址,直接顯示文字。 第三個仍指向 8922,但檔案回應加入附件標頭。這次 Chromium 產生下載事件,採用回應中的 server-guide.txt。保存第一與第三份文件後核對雜湊,內容一致,差別在連結來源和回應用途。 同源 + download:本例產生下載 跨來源...
2026-10-04 68 0
文尼先生 2026-10-04

網站上的下載連結寫「模板檢查表」,存到電腦後卻變成一串百分比編碼,或只剩download.csv。先別重新壓縮整包檔案:瀏覽器採用的檔名,可能來自下載回應的Content-Disposition,與頁面上的連結文字不同。 這篇處理下載檔名與UTF-8編碼。檔案能否下載、會員是否有權限,則屬於另外的功能;檔名顯示正常,也不能證明下載內容正確。 先分清檔名與檔案內容 下載後,先看錯的是「名稱」還是「打開後的文字」。CSV內中文字亂碼,可能要查檔案實際位元組與開啟軟體;檔案內容正常、名稱卻奇怪,則先查回應標頭。不要把CSV內容加了UTF-8設定,就認定檔名一定跟著修好。 另外記下來源網址與瀏覽器。下載可能經過重新導向,真正送出檔案的是最後一個回應;查看第一個入口的標頭,未必看得到檔名設定。頁面上的下載按鈕文字,也不等於伺服器建議的名稱。 在最後一個回應找Content-Disposition 開啟瀏覽器開發者工具的Network,保留請求記錄,再按下載。找到真正回傳檔案的請求,讀Response Headers。例如: Content-Type: text/csv; charset=utf-8 Content-Disposition: attachment; filename="template-check.csv" attachment表示以附件處理,filename提供建議名稱。這份例子只提供ASCII名稱,所以中文標題不會自動出現在下載檔名。實際儲存行為仍由瀏覽器與檔案系統處理,不要把它當成可以指定訪客電腦完整路徑的指令。 若沒有這個標頭,瀏覽器可能依URL或其他條件取得名稱。先記錄目前回應,不必立刻到所有頁面加相同屬性;請維護下載程式的人核對真正送檔的入口。 中文名稱放在filename*,保留簡單備用檔名 需要非ASCII名稱時,可由回應提供filename*,使用指定字元編碼及百分比編碼。下面同時保留英文備用名稱,中文部分代表「模板檢查.csv」: Content-Disposition: attachment; filename="template-check.csv"; filename*=UTF-8''%E6%A8%A1%E6%9D%BF%E6%AA%A2%E6%9F%A5.csv UTF-8''後方是UTF-8檔名的編碼,不是把中文字隨便塞進標頭。支援這個參數的處理端會優先使用filename*;保留ASCII的filename,可讓不理解擴充寫法的處理端還有合理名稱。 注意兩個單引號的位置,也不要同時輸出兩個相同的filename*。如果使用的框架已有下載回應方法,先查它如何接收Unicode檔名與產生標頭,不要在既有設定後再手動追加一份,造成重複參數。 百分比編碼只做一次 常見失誤是先把檔名編成%E6...,再交給會自行編碼的程式。第二次把百分比符號變成%25,瀏覽器解碼一次後,仍得到一串%E6...,而非原本的中文。 可先用JavaScript查看一次編碼的結果,但實際標頭仍由下載伺服器產生: encodeURIComponent('模板檢查.csv'); // %E6%A8%A1%E6%9D%BF%E6%AA%A2%E6%9F%A5.csv 這個例子不包含撇號等需要額外處理的字元,不能把它當成完整通用的Content-Disposition產生器。正式程式應使用框架或函式庫提供的標頭編碼方法,先確認輸入要的是原始Unicode名稱,還是已編碼字串。 不要把擴充參數的寫法直接搬進普通filename。百分比編碼在filename中的處理並非所有瀏覽器一致,可能一個瀏覽器看起來正常,另一個保留原字串。可預期的ASCII備用名稱,比把同一串編碼塞進兩個欄位更容易維護。 用同一份內容,確認改的是哪一層 準備一份不含客戶資料的小檔案,做三個測試回應:只有ASCII備用名稱、filename*編碼一次、filename*重複編碼。檔案內容保持完全相同,再比較瀏覽器建議名稱與下載後的內容。 本文CSV案例的三個入口送出相同位元組;Chromium取得的名稱依序是template-check.csv、模板檢查.csv與仍帶百分比文字的名稱。這能分清標頭造成的差異,不代表所有瀏覽器都會給出相同結果。 保存下載檔後,再以同一種方式查看內容或計算雜湊。若三份內容相同,就別把名稱修正說成資料修復。反過來,如果內容也不同,回頭查是否拿到了登入頁、錯誤訊息或另一個檔案,不能只靠副檔名判斷。 別把路徑與私人資料當成檔名 檔名只需要識別文件。避免使用完整伺服器路徑、私人Email或客戶識別碼,也不要相信使用者傳入的檔名可以直接寫進標頭。保留合理副檔名,清理控制字元與路徑分隔符;下載目標仍由功能自己的資料與授權流程決定。 瀏覽器可能為配合檔案系統調整不允許的字元。同名檔案已存在時,儲存端也可能加序號。看到「模板檢查(1).csv」,先確認是否是本機已有同名檔,而不是立刻判定伺服器又多編碼一次。 修正前保存原下載回應設定和標頭,只改一個測試入口。用自己的正式支援瀏覽器重試中文、空白與ASCII名稱,確認內容、格式、檔名都正確,再擴大到其他下載功能。 如果檔名正常卻無法下載,請另查回應狀態與下載行為;如果內容開啟後亂碼,則把實際檔案交給負責內容編碼的人。這樣維護者知道應該修標頭、檔案位元組,還是下載功能本身。 參考資料 MDN:Content-Disposition RFC 6266:HTTP附件檔名與擴充參數 RFC 8187:HTTP標頭參數的字元編碼 MDN:encodeURIComponent
2026-10-04 82 0
文尼先生 2026-10-04

舊文章網址最後能開啟,不代表中間沒有繞路。瀏覽器可能先從舊路徑轉到過渡頁,再轉到新文章;地址列只留下最後一個網址,兩次跳轉就被藏起來了。 排查重新導向串時,先保留每一步的 URL、狀態碼與 Location,確認哪一步還有必要。這篇用兩段 HTTP 回應示範怎麼追,不處理 canonical 的選擇,也不要求一開始修改正式主機規則。 先看第一個回應,不自動追到底 在開發者工具的 Network 勾選保留記錄,再輸入舊網址。找到第一個文件請求,檢視 Status 與 Response Headers 的 Location。接著找 Location 指向的下一個請求,重複到最後頁面。 例如舊路徑 /old-guide 回301,Location 是 /middle-guide;middle-guide 再回302,Location 是 /final-guide;final-guide 才回200。訪客要讀最後的文章,瀏覽器先做了兩次轉向。 /old-guide → 301 Location: /middle-guide /middle-guide → 302 Location: /final-guide /final-guide → 200 Location 可以是相對地址,不能只把字串貼在另一個網域上猜。按上一個回應的 URL 解析,再核對實際下一個請求。遇到跨網域、http轉https或尾斜線變更,也各自算一步,別把它們合併成「瀏覽器自己修好了」。 用 curl 儲存每一步 在 Windows 終端機可明確使用 curl.exe,避免叫到不同工具的同名指令。先用不帶 -L 的請求檢視第一個回應;-o NUL 不輸出正文,-D - 把標頭寫到畫面: curl.exe -sS -D - -o NUL "https://example.com/old-guide" Linux 或 macOS 把 NUL 換成 /dev/null。這裡仍是 GET,不是 HEAD;有些網站對 HEAD 的處理不同,拿 HEAD 的結果代替訪客實際GET可能漏掉差異。對需要登入或特殊 Cookie...
2026-10-04 57 0
文尼先生 2026-10-04

同一個 app.js,檔案內容沒變,Network 顯示的下載容量卻不同,不一定是模板漏載入。瀏覽器收到的資料可以先壓縮,再解壓成原本的 JavaScript。要比較大小,先分清「傳輸中的回應內容」與「解壓後的檔案」。 312 bytes 和 1,371 bytes,哪個才是真的? 用一份載入 20 個範例項目的 JS 比較兩種回應:未壓縮原文是 1,371 bytes;gzip 回應的原始內容是 312 bytes,解壓後仍是 1,371 bytes,內容逐位元組相同。瀏覽器收到 gzip 版本後,頁面照樣顯示 20 個項目。 回應方式回應內容容量解壓後內容未壓縮1,371 bytes1,371 bytesgzip312 bytes1,371 bytes 這只是這份範例的數字,檔案內容與壓縮設定不同,結果也會不同。HTTP 標頭、連線成本並不包含在表中的回應內容容量裡;它不能直接換算成整站加速比例。 先讀這三個標頭 在 DevTools 的 Network 點選 JS:請求的 Accept-Encoding 表示客戶端能接受哪些編碼;回應的 Content-Encoding: gzip 才表示這筆內容使用了 gzip。有列在請求裡,不等於伺服器一定選用。 如果回應帶有 Content-Length,搭配 gzip 時,它描述的是編碼後的內容長度。工具可能另顯示解壓後大小,下載工具也可能自動解壓;不要拿不同口徑的兩個數字,判斷哪個檔案有缺漏。 同一網址依 Accept-Encoding 提供不同版本時,回應的 Vary: Accept-Encoding 可讓快取按這個請求標頭區分版本。它是快取選擇條件,不是「已啟用 CDN 加速」的證明。 確認功能正常,再談壓縮設定 查清回應狀態、標頭與實際內容,再看頁面功能:JS 是否執行、選單或列表是否正常。要比原始傳輸內容,先確認取樣工具沒有自動解壓;要比程式內容,則把 gzip 解壓後再和未壓縮版本比對。 不用把已壓縮的圖片、ZIP 再強行套 gzip;重複壓縮可能沒好處,甚至更大。這個檢查方法也不代表來源伺服器或 CDN 設定需要更改。真的要調整,先在自己的測試環境保存設定與回滾方式,核功能後再決定,不為追求小數字直接改正式站。 參考資料 MDN:Content-Encoding MDN:Accept-Encoding MDN:Vary 資料核對:2026年10月4日。文件與網站環境可能更新,操作前請核對自己的設定。
2026-09-27 53 0
文尼先生 2026-09-27
顯示驗證碼
沒有帳號?註冊  忘記密碼?