實作指南

資料參考與開發工作流程指南

從電話、身分 ID 與 locale 的資料界線,到 JSON、JWT、URL、時間、密碼與 Open Graph 的實作檢查。

開發工作流程

CSV 轉 JSON:保留文字,修正有歧義的資料列

保留前導零與長編號,理解 CSV 引號規則,並在轉換前修正重複欄名、缺欄與 UTF-8 編碼問題。

Gzip、Zlib 與 Raw DEFLATE:容器、位元組與本機預覽界線

選對壓縮容器,理解 Base64 與 HTTP 解碼,並在原生瀏覽器與資源上限內保留完整二進位輸出。

UUID 版本、編碼時間與隱私界線

辨識 UUID 版本與 variant、比較 v1/v6/v7 編碼時間,理解解碼欄位不能證明的事情,再匯出識別碼。

CSS 影像濾鏡:順序、作用範圍與安全預覽

理解濾鏡順序、中性值、模糊外溢與本機圖片限制,再使用產生的 CSS;模糊不是敏感資料遮蔽。

CSS 2D 變形:順序、原點與參考盒子

比較位移與旋轉順序、百分比參考盒子、transform-origin 與不可逆縮放,再複製原生 CSS 變形。

CSS 文字陰影:圖層、溢出與文字可讀性

了解 text-shadow 順序、繼承、繪製溢出與強制色彩,再用實際文字核對工具的八層限制。

CSS border-radius:橢圓角與半徑重疊縮減

理解順時針角落順序、斜線分隔半徑、百分比尺寸與瀏覽器重疊縮減,再使用 border-radius CSS。

CSS clip-path polygon:座標、裁切與焦點界線

理解多邊形頂點順序、百分比座標、長寬比例、原生填滿規則及焦點裁切,再使用產生的 clip-path CSS。

CSS box-shadow:多層陰影、內陰影與裁切

理解 box-shadow 層順序、負擴散值、內陰影與 overflow 裁切,再將產生的 CSS 用於實際介面。

CSS 漸層色標、硬邊界與文字對比

正確理解線性與放射漸層色標、建立硬邊界,並在實際版面檢查文字對比。

Flexbox 尺寸、換行與來源順序

理解 Flexbox 主軸、項目尺寸與換行,再將產生的版面帶回專案。

CSS Grid 區塊:視覺版面、軌道與原始碼順序

建立矩形 grid-template-areas、理解欄列尺寸,並在使用產生的 CSS 前檢查 HTML 閱讀順序。

CSS 動態曲線:控制點、過衝與減少動態

理解 cubic-bezier() 座標,在相同時間下比較速度變化,並在實際元件中尊重減少動態偏好。

CSS clamp() 流動字級:公式與無障礙檢查

發布 clamp() 字級前,核對端點、rem 根字級假設、瀏覽器支援與 200% 文字縮放。

XML 格式化:良構、空白與驗證界線

了解 XML 語法檢查能證明什麼、空白為何可能影響內容,以及何時需要 XSD 驗證。

把 JSON 轉成 TypeScript,但不要相信單一範例

用 JSON 範例開始建立 TypeScript contract,同時把 runtime 檢查分開處理。

檢視 JWT claims,但不要把它當成證明

在本機讀取 JWT metadata 來除錯,同時把簽章驗證與授權分開。

URL 編碼:編碼資料,不是整個網址

在本機檢視 URL 元件,避免重複編碼 query value 或 path。

轉換時間戳,但不要遺失時區

保留同一時間點、標示來源時區,並明確處理夏令時間缺口。

在本機產生密碼,再正確保護它

使用唯一隨機密碼,並把產生與保存、復原、伺服器端雜湊分開。

分享頁面前驗證 Open Graph metadata

在本機建立已跳脫的社群 metadata,並檢查 canonical URL、標題與描述是否說同一件事。

閱讀文字差異,不把雜訊當成變更

在本機比較兩份文字版本,有意識地處理空白,並知道何時 diff 並不足夠。

Cronie 排程:日欄位、DST 與 step 值

閱讀五欄位 Cronie 排程,不把它和其他 cron 方言或部署證明混為一談。

WCAG 色彩對比:正確判讀比例,不過度宣稱

套用 WCAG 2.2 文字與非文字對比門檻,理解大型文字定義,以及兩色比例無法證明的範圍。

HTML 跳脫:依輸出情境正確編碼

正確編碼 HTML 文字與引號屬性,分清字元參照、內容清理,以及 JavaScript、CSS 與 URL 安全。

Unix 檔案權限:不靠猜測讀懂 chmod 模式

轉換 Unix 權限模式、區分檔案與目錄,並檢查特殊位元;不要把計算器當成存取決策。

Intl 複數規則與可見小數位指南

了解 Intl.PluralRules 的基數與序數類別、JavaScript 預設小數位及可見小數位如何影響不同語系。

i18n JSON 語系檔檢查指南:精確路徑與翻譯界線

檢查翻譯漏鍵時避免混淆字面點號與巢狀 JSON,理解空值、複數與 fallback 例外、placeholder 及報告隱私界線。

JSON Pointer、JSON Patch 與 Merge Patch:路徑及安全修改

區分精確 JSON 路徑與查詢,選擇原子修改格式,並在本機匯出時保留 null、空鍵與數字精度。

CSV 工作流程:保留字串、關聯合併、主鍵比對與 SQL 匯出

保留 CSV 識別碼、依唯一查表鍵關聯合併、比對版本,並理解試算表公式風險與 PostgreSQL 匯出界線。

資料遮罩與 .env 比對:遮蔽不能證明什麼

匯出 .env 鍵名比對時保留值的私密性,並在核對 JSON 候選路徑後選擇要遮罩的值。

JSON 扁平化指南:路徑、碰撞與可重建資料

理解固定點號/括號路徑慣例,保留空容器,並在扁平化 JSON 前拒絕有歧義鍵名、陣列缺格與精度損失。

Intl 數字格式:精度、語系預設與不可見分隔符號

保留十進位輸入精度、區分顯示捨入與運算,並在複製 Intl.NumberFormat 程式碼前檢查貨幣預設、語系解析及 Unicode 分隔符號。

Unicode 正規化、隱藏字元與文字編碼

區分位元組與 Unicode 文字、比較標準與相容正規化,並檢查隱藏字元,不破壞必要的語言或 emoji 內容。

日曆日期、ISO 週年與經過時長

選擇日曆日期運算而不是相減時間戳,理解 ISO 週年邊界,並將帶正負號的時長與鐘面時間分開。

單次 ICS 事件:UTC、全天日期與文字安全

以明確 UTC 時間或不包含結束日的全天日期產生單次 iCalendar 事件,再檢查 UTF-8 折行、文字跳脫與行事曆匯入行為。

指數退避與抖動:重試時間及期限界線

以封頂指數退避、抖動、Retry-After 與選填期限,計算重試等待及開始時間範圍。

HTTP Range 與 Content-Range:精確位元組、206、416 及續傳界線

理解含端點的位元組位移、suffix、編碼後表示資料及 If-Range,再判讀部分下載;分清離線模型與實際伺服器行為。

HTTP 標頭:快取政策、重複欄位與下載檔名

閱讀標頭時不誤合併 Set-Cookie,區分快取驗證與儲存,並安全產生引號 ASCII 及 UTF-8 下載檔名。

CSP 與 CORS:不同的瀏覽器界線,不是安全證書

區分內容來源政策與跨來源回應分享,理解 nonce 及預檢要求,並在不削弱防護的前提下驗證部署行為。

robots.txt、XML Sitemap 與 hreflang:分開檢查 SEO 契約

區分爬取許可、網址探索與語言對應,檢查 XML 及語言映射,不把離線語法檢查當成收錄證明。

JSON-LD:真實結構化資料與安全 script 整合

明確選擇 Article、BreadcrumbList 或 WebSite,維持標記與可見內容一致,區分 JSON 合法、安全嵌入與複合式結果資格。

Android App Links:準備與發布 assetlinks.json

準備 Android Digital Asset Links 宣告、保留既有關聯,並在 Android 上驗證部署後的設定。

iOS Universal Links 的 AASA 部署與除錯指南

透過 HTTPS 部署 apple-app-site-association、在 Xcode 設定 Associated Domains,並排查仍在瀏覽器開啟的連結。

Cookie 與 HAR 檢查:不要把憑證一起分享

區分 Cookie 與 Set-Cookie、如實閱讀缺少的網路時間,在本機檢查 HAR,不重播請求或分享原始秘密。

URI Template:展開、編碼與目的地界線

理解 RFC 6570 運算子、空值與缺值、清單及映射,不把模板展開當成可信任網址或網路請求。

IPv6、CIDR 與 IANA:精確範圍,不是路由或服務證明

閱讀 IPv6 表示、精確 CIDR 集合及附日期 IANA 位址與 port 登錄,不擴大政策或推論即時可達性。

DNS 紀錄:Zone-file 語法、TXT 位元組與發布檢查

建立 A、AAAA、CNAME、MX、TXT、NS、PTR、CAA 與 SRV 紀錄,區分 zone-file 文字及供應商表單,再另驗發布。

文件表格:跳脫、Caption 與可讀標頭

將 CSV 轉成簡單 Markdown 或 HTML 資料表,不執行儲存格標記、不遺失文字值,也不讓輔助科技失去表格結構。

本機圖片:像素差異、裁切與匯出界線

不默默縮放地比較解碼像素,明確選擇裁切及 JPEG 背景,理解原生編碼與取樣配色。

PWA 圖示:圓形 Maskable 安全區不等於可安裝

將圖稿放進半徑 40% 的 maskable 圓,匯出一般與 maskable PNG,再發布自訂 Manifest,不宣稱已可安裝。

SVG 路徑:命令端點與原生近似幾何

閱讀 d 路徑命令、相對座標與弧線旗標,區分瀏覽器估計長度、精確幾何及描邊邊界。

CSS 檢查與排版:Inert Selector、捲動吸附及多欄

不執行 HTML 地測試 Selector,區分吸附視口內距及元素間距,檢查窄螢幕多欄閱讀順序。

CSS color-mix:獨立比例、Alpha 與原生支援

理解省略比例及正規化、比較原生色彩空間,區分瀏覽器色塊、對比及外觀保證。

ULID 時間戳記:Crockford 編碼、排序與隱私界線

精確解碼 ULID 毫秒、區分 Crockford Base32 與 RFC 4648,理解填補、溢位、批次錯誤,以及可排序識別碼不能證明的事情。

Hex 位元組:位置、不含結尾的範圍與大小端序

不修改二進位資料,區分可列印 ASCII 與 UTF-8、解讀精確整數,並在明確本機資源上限內匯出位元組範圍。

Base32:選擇字母表並維持標準填補

區分 RFC 4648 Base32 與 base32hex、理解未使用位元,檢視非 UTF-8 資料,不把編碼當成加密。

IEEE 754:精確儲存十進位、直接捨入及相鄰值

閱讀 binary32 與 binary64 欄位,避免十進位先轉 double 再轉 float 的雙重捨入,區分 NaN、有號零與次正規值。

位元運算:明確寬度、有號範圍及完整寬度位移

維持最多 128 位元整數精度,區分允許的輸入範圍與輸出解讀,理解遮罩、符號填滿及循環位移。

Protobuf Wire 資料:位元組邊界不是 Schema

閱讀 tag、uint64 varint 及固定寬度位元組範圍,區分長度資料與推測的字串或巢狀訊息。

SSH 公開金鑰:Wire 結構、SHA256 指紋與信任

檢查支援的 OpenSSH 公鑰欄位、比對原始 blob 的摘要,理解指紋為何不能識別擁有者身分。

本機閱讀 OpenAPI,不隱藏無法解析的參照

匯出 OpenAPI 摘要前,追查操作繼承與有界 JSON 參照。

cURL 轉程式碼:body 與執行環境限制

將靜態命令轉成 Fetch 或伺服器端程式碼,並檢查 body、header、重新導向及執行環境限制。

轉換字幕時間,明確揭露 WebVTT 資訊損失

選擇 SRT/WebVTT,以整數毫秒位移且不截為零,檢查 cue ID、settings、順序與重疊。

建立 vCard 4.0:正確 UTF-8 折行與聯絡資訊隱私

區分聯絡資料序列化與驗證,安全跳脫 TEXT,依 octets 而非 JavaScript 字串長度折行。

閱讀 Geohash 格網,不誤稱位置準確度

理解經度優先二分、精確角度邊界、中心、換日線環繞與不存在的極區鄰格。

閱讀 SSE 紀錄,不擅自補出缺少的事件

理解空白行派送、多行 data、繼承 ID、retry 狀態,以及離線 Server-Sent Events 紀錄的界線。

瀏覽器 DNS、IP 與 HTTP 請求:同意、CORS 與隱私

確認明確網路請求的目的地、對方可見資料,以及為何瀏覽器可見回覆不等於伺服器狀態或資安合格證明。

本機格式工具:保留意義,拒絕不安全執行

先分清格式化、壓縮、Schema 驗證與資料模型轉換,再複製 JSONPath、HTML、XML、CSS、JavaScript 或 SVG 結果。

文字估計、遮罩與瀏覽器計時:實務限制

善用閱讀估計、明確遮罩規則與本機計時,不把啟發式當成匿名化、身分驗證或可靠背景鬧鐘。