布詳解：REPL 錯(cuò)誤修復(fù)、bare 模式 Source Map 優(yōu)化與詞法細(xì)節(jié)改進(jìn))
編程語言編譯器【免費(fèi)下載鏈接】coffeescriptUnfancy JavaScript項(xiàng)目地址https://gitcode.com/gh_mirrors/co/coffeescript點(diǎn)擊查看免費(fèi)下載導(dǎo)讀CoffeeScript 1.9.3 于 2015 年 5 月 27 日發(fā)布是 1.9.x 系列的一個(gè) bugfix 版本。本篇文章基于倉庫中的 1.9.3 變更日志 展開逐一解讀該版本修復(fù)的隱式調(diào)用中對(duì)象首鍵插值問題、REPL 錯(cuò)誤信息與若干交互缺陷、--bare編譯下的 Source Map 修正并順帶帶來更小的 map 體積、編譯后塊注釋的格式改進(jìn)以及on/off/yes/no關(guān)鍵字的報(bào)錯(cuò)優(yōu)化。讀完本文你將理解這些修復(fù)背后的詞法、語法樹與源碼映射機(jī)制并能對(duì)照 src/ 下的編譯器源碼定位每一處改動(dòng)的實(shí)現(xiàn)細(xì)節(jié)。版本背景與發(fā)布信息發(fā)布日期2015-05-27版本號(hào)1.9.3上一個(gè)版本1.9.2倉庫中每個(gè)版本變更日志的頭部都通過releaseHeader函數(shù)統(tǒng)一生成發(fā)布信息參見 0.1.0.md 等全部 changelog 文件releaseHeader(2015-05-27, 1.9.3, 1.9.2)該函數(shù)聲明了發(fā)布日期、當(dāng)前版本號(hào)與上一版本號(hào)三個(gè)參數(shù)。1.9.3 屬于 1.9.x 穩(wěn)定分支的小版本全部改動(dòng)均為 bugfix 與錯(cuò)誤處理改進(jìn)未引入新語法特性。修復(fù)一隱式調(diào)用中對(duì)象字面量首鍵的插值Bugfix for interpolation in the first key of an object literal in an implicit call.問題場(chǎng)景CoffeeScript 允許省略調(diào)用括號(hào)implicit call例如console.log foo: #{name}此時(shí)foo: #{name}會(huì)被解析為傳給console.log的對(duì)象字面量。當(dāng)對(duì)象字面量的第一個(gè)鍵本身包含字符串插值interpolation時(shí)詞法分析器Lexer在#與后續(xù)插值表達(dá)式之間切換詞法狀態(tài)的過程中會(huì)出現(xiàn)歧義#既是插值起始標(biāo)記又是行注釋起始標(biāo)記。1.9.3 修復(fù)了在隱式調(diào)用語境下該首鍵插值無法被正確識(shí)別的 bug。底層機(jī)制CoffeeScript 的字符串插值由 src/lexer.coffee 負(fù)責(zé)詞法分析器通過一組按優(yōu)先級(jí)排列的正則嘗試匹配 token見tokenize主循環(huán)約 L65-L89。插值發(fā)生時(shí) Lexer 會(huì)進(jìn)入interpolateString等內(nèi)部狀態(tài)而對(duì)象字面量首鍵位置的 token 類型判定IDENTIFIER、STRING還是其他取決于前序 token 的上下文。從源碼結(jié)構(gòu)看詞法分析器使用COFFEE_KEYWORDS與COFFEE_ALIASES判斷標(biāo)識(shí)符是否為關(guān)鍵字見 src/lexer.coffee 中identifierToken相關(guān)邏輯約 L121-L160并在 token 前一個(gè)為關(guān)鍵字時(shí)將prev改寫為IDENTIFIER。本版本修復(fù)的是該判定流程在隱式調(diào)用 對(duì)象首鍵 插值這一組合下的邊界情況確保{ #{key}: value }這類寫法無論位于調(diào)用列表何處都能穩(wěn)定解析。修復(fù)二REPL 錯(cuò)誤信息與交互細(xì)節(jié)Fixed broken error messages in the REPL, as well as a few minor bugs with the REPL.REPL 的實(shí)現(xiàn)位置CoffeeScript 的交互式命令行coffee -i或coffee無參數(shù)進(jìn)入由 src/repl.coffee 實(shí)現(xiàn)。它以 Node.js 內(nèi)置的repl模塊為基礎(chǔ)覆蓋了自定義的eval函數(shù)將 Node REPL 對(duì)輸入包裹的額外括號(hào)剝離/^\(([\s\S]*)\n\)$/m剝離新版 Node REPL 包裹的try { ... } catch結(jié)構(gòu)約 L17-L25通過CoffeeScript.tokens分詞、CoffeeScript.nodes構(gòu)建 AST再以bare: yes編譯為 JavaScript 后在 VM 上下文中執(zhí)行約 L30-L65。錯(cuò)誤信息修復(fù)舊版本中REPL 里出現(xiàn)語法錯(cuò)誤時(shí)由于錯(cuò)誤對(duì)象缺少源碼位置信息打印出的報(bào)錯(cuò)往往無法定位到具體行甚至顯示為空白。1.9.3 引入updateSyntaxError來修正這個(gè)問題——在catch分支中調(diào)用它把源碼文本與行號(hào)補(bǔ)寫進(jìn)錯(cuò)誤對(duì)象catch err # ASTs compile does not add source code information to syntax errors. updateSyntaxError err, input cb errsrc/repl.coffee 約 L66-L69updateSyntaxError定義于 src/helpers.coffee 約 L227 處。當(dāng)錯(cuò)誤對(duì)象已帶位置時(shí)直接返回否則將錯(cuò)誤對(duì)象包裝為帶location數(shù)據(jù)的SyntaxError并把 CoffeeScript 源碼按行保存到錯(cuò)誤的code屬性中。這樣 REPL 拋出的錯(cuò)誤就能被正確格式化并指向具體源碼行與coffee命令行編譯報(bào)錯(cuò)的行為保持一致。其他交互修復(fù)本版本還順帶修復(fù)了 REPL 的幾個(gè)小缺陷主要包括多行輸入處理addMultilineHandler支持Ctrl-V切換多行模式src/repl.coffee與命令歷史持久化addHistory寫入~/.coffee_history約 L129-L167中的邊界問題例如歷史文件截?cái)鄷r(shí)多出的半個(gè)行、首行空記錄等。修復(fù)三--bare編譯下源碼映射Source Map修正Fixed source mappings for tokens at the beginning of lines when compiling with the--bareoption. This has the nice side effect of generating smaller source maps.--bare與源碼映射的關(guān)系默認(rèn)情況下CoffeeScript 編譯產(chǎn)物會(huì)包裹在(function(){ ... }).call(this);的 IIFE 中--bare選項(xiàng)去掉這層包裝直接輸出頂層代碼常用于瀏覽器端直接執(zhí)行或與其他模塊體系配合。這個(gè)差異會(huì)影響生成的 JavaScript 與原始 CoffeeScript 之間的行列對(duì)應(yīng)關(guān)系。修復(fù)內(nèi)容此前使用--bare編譯時(shí)位于輸出行行首的 token的源碼映射source mapping不準(zhǔn)確。原因在于非 bare 模式下包裝函數(shù)代碼本身占據(jù)了若干偏移編譯器據(jù)此對(duì)生成位置做補(bǔ)償而在 bare 模式下沒有這些偏移位于行首的 token 的first_column補(bǔ)償邏輯與實(shí)際生成位置存在偏差。修復(fù)后行首 token 的映射位置被正確記錄。該修復(fù)同時(shí)帶來一個(gè)附帶收益生成的 source map 更小。這是因?yàn)長ineMap中按列存儲(chǔ)映射見 src/sourcemap.litcoffee不再為錯(cuò)誤的列位置重復(fù)寫入冗余的 VLQ 段mappings字符串長度隨之縮短。源碼映射機(jī)制速覽Source Map 模塊位于 src/sourcemap.litcoffeeLineMap保存單行輸出代碼中每個(gè)列位置對(duì)應(yīng)的[sourceLine, sourceColumn]SourceMap由多行LineMap組成提供add登記映射與sourceLocation反查原始位置generate產(chǎn)出 v3 格式的 JSON 對(duì)象mappings字段通過自定義的encodeVlqBase64 VLQ 編碼src/sourcemap.litcoffee生成緊湊字符串。編譯器入口 src/coffeescript.coffee 在options.sourceMap或options.inlineMap時(shí)生成 map并可通過//# sourceMappingURL指令嵌入或外鏈約 L54-L66 與 L167-L176。此外該文件還使用緩存的 source map 對(duì)運(yùn)行時(shí)棧追蹤進(jìn)行反查讓報(bào)錯(cuò)堆棧指向 CoffeeScript 原始源碼約 L308-L315。命令行中使用方式coffee --bare --map file.coffee # 或 coffee -b -m file.coffee修復(fù)四編譯后塊注釋Block Comment的格式改進(jìn)Slight formatting improvement of compiled block comments.CoffeeScript 的塊注釋以### ... ###書寫編譯后轉(zhuǎn)為/* ... */。1.9.3 對(duì)轉(zhuǎn)換后的排版做了小幅改進(jìn)使得多行塊注釋的輸出更加整潔。底層實(shí)現(xiàn)在 src/nodes.coffee 的HereComment類約 L1604-L1636# Comment delimited by ### (becoming /* */). exports.HereComment class HereComment extends Base compileNode: (o) - multiline \n in content # Unindent multiline comments. They will be reindented later. if multiline indent null for line in content.split \n leadingWhitespace /^\s*/.exec(line)[0] if not indent or leadingWhitespace.length indent.length indent leadingWhitespace content content.replace /// \n #{indent} ///g, \n if indent ...該版本改進(jìn)主要體現(xiàn)在縮進(jìn)處理上多行塊注釋先統(tǒng)一去掉公共最小縮進(jìn)編譯時(shí)再按當(dāng)前輸出層級(jí)重新縮進(jìn)同時(shí)保留注釋內(nèi)部的換行結(jié)構(gòu)使/* ... */的生成結(jié)果與源碼縮進(jìn)風(fēng)格保持一致避免輸出中出現(xiàn)多余的空白行或錯(cuò)位縮進(jìn)。修復(fù)五on/off/yes/no的錯(cuò)誤信息優(yōu)化Better error messages foron,off,yesandno.關(guān)鍵字別名機(jī)制CoffeeScript 將yes/no/on/off作為布爾字面量的別名與true/false等價(jià)。這一映射定義在 src/lexer.coffee 的COFFEE_ALIAS_MAP中COFFEE_ALIAS_MAP and : or : || is : isnt : ! not : ! yes : true no : false on : true off : false COFFEE_ALIASES (key for key of COFFEE_ALIAS_MAP) COFFEE_KEYWORDS COFFEE_KEYWORDS.concat COFFEE_ALIASESsrc/lexer.coffee 約 L1241-L1253即COFFEE_KEYWORDS在undefined, Infinity, NaN, then, unless, until, loop, of, by, when的基礎(chǔ)上追加了全部別名。改進(jìn)點(diǎn)由于on、off、yes、no會(huì)被詞法分析器改寫為true/false此前當(dāng)用戶將它們用作變量名或嘗試賦值時(shí)報(bào)錯(cuò)信息往往晦澀難懂例如提示unexpected identifier。1.9.3 改進(jìn)了針對(duì)這四個(gè)詞的錯(cuò)誤信息。詞法層相關(guān)邏輯可見 src/lexer.coffee當(dāng)別名作為標(biāo)識(shí)符出現(xiàn)時(shí)lexer 根據(jù)上下文決定是否將其改寫為關(guān)鍵字identifierToken中COFFEE_KEYWORDS判斷約 L143-L155對(duì)不可賦值名稱的統(tǒng)一判定在isUnassignable中約 L1190-L1198其中對(duì)JS_KEYWORDS/COFFEE_KEYWORDS輸出 keyword xxx cant be assigned、對(duì)保留字輸出 reserved word xxx cant be assigned。優(yōu)化后當(dāng)你寫出以下代碼on 1 # 錯(cuò)誤keyword on cant be assigned yes true # 錯(cuò)誤keyword yes cant be assigned編譯器會(huì)直接指出對(duì)應(yīng)詞屬于 CoffeeScript 關(guān)鍵字/別名并提示其不可賦值或不可作為函數(shù)名使用后者對(duì)應(yīng) src/lexer.coffee 約 L210-L216 中g(shù)et/set被誤用時(shí)的報(bào)錯(cuò)分支采用同樣的明確說明違規(guī)用法的報(bào)錯(cuò)風(fēng)格。如何驗(yàn)證這些修復(fù)使用 REPL 驗(yàn)證錯(cuò)誤信息coffee coffee yes 1 # Error: keyword yes cant be assigned驗(yàn)證 bare 模式 Source Mapcoffee -b -m -c sample.coffee # 生成 sample.js 與 sample.js.map對(duì)比 1.9.2 與 1.9.3 生成的sample.js.map中mappings字段長度可觀察到后者更短且使用瀏覽器 DevTools /source-map庫反查行首 token 時(shí)定位更準(zhǔn)確。驗(yàn)證塊注釋格式### a b ###編譯后輸出/*\n a\n b\n*/縮進(jìn)按公共前綴收斂、輸出層級(jí)重排多行結(jié)構(gòu)得以保留。小結(jié)CoffeeScript 1.9.3 雖然只包含 bugfix但覆蓋了編譯器管線的多個(gè)關(guān)鍵環(huán)節(jié)詞法分析對(duì)象首鍵插值、關(guān)鍵字別名報(bào)錯(cuò)、REPL 運(yùn)行時(shí)錯(cuò)誤信息與交互、代碼生成與源碼映射--bare行首 token 映射、塊注釋排版。這些改動(dòng)共同提升了 1.9.x 分支在真實(shí)工程中的健壯性與可調(diào)試性。相關(guān)實(shí)現(xiàn)均可對(duì)照 src/lexer.coffee、src/repl.coffee、src/helpers.coffee、src/sourcemap.litcoffee 與 src/nodes.coffee 繼續(xù)深入閱讀。贊分享編程語言編譯器【免費(fèi)下載鏈接】coffeescriptUnfancy JavaScript項(xiàng)目地址https://gitcode.com/gh_mirrors/co/coffeescript點(diǎn)擊查看免費(fèi)下載相關(guān)推薦TDesign MiniProgram 1.9.3版本發(fā)布組件優(yōu)化與問題修復(fù)TDesign MiniProgram 1.9.3版本發(fā)布組件優(yōu)化與問題修復(fù) TDesign MiniProgram是騰訊開源的一套小程序組件庫為開發(fā)者提供小程序UI組件前端設(shè)計(jì)系統(tǒng)Node.js 4.8.3 (Maintenance) 發(fā)布詳解全局模塊加載修復(fù)、TLS 段錯(cuò)誤修復(fù)與發(fā)布文檔全解讀Node.js 4.8.3 Maintenance 發(fā)布詳解全局模塊加載修復(fù)、TLS 段錯(cuò)誤修復(fù)與發(fā)布文檔全解讀 Node.js 4.8.3 是 Node.j前端文檔Cookiecutter 2.7.1 發(fā)布解析版本號(hào)誤報(bào)修復(fù)與 CI 并行化改進(jìn)Cookiecutter 2.7.1 發(fā)布解析版本號(hào)誤報(bào)修復(fù)與 CI 并行化改進(jìn) 本篇文章以 Cookiecutter 2.7.1 的官方發(fā)布說明 CHAN開發(fā)工具CLI代碼生成上一篇Persona快速入門指南5個(gè)步驟讓您的網(wǎng)站支持無密碼登錄下一篇Seelen UI 能做什么Windows 10/11 用戶自定義桌面的實(shí)用指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 CoffeeScript 1.9.3 發(fā)布詳解：REPL 錯(cuò)誤修復(fù)、bare 模式 Source Map 優(yōu)化與詞法細(xì)節(jié)改進(jìn)
編程語言編譯器【免費(fèi)下載鏈接】coffeescriptUnfancy JavaScript項(xiàng)目地址https://gitcode.com/gh_mirrors/co/coffeescript點(diǎn)擊查看免費(fèi)下載導(dǎo)讀CoffeeScript 1.9.3 于 2015 年 5 月 27 日發(fā)布是 1.9.x 系列的一個(gè) bugfix 版本。本篇文章基于倉庫中的 1.9.3 變更日志 展開逐一解讀該版本修復(fù)的隱式調(diào)用中對(duì)象首鍵插值問題、REPL 錯(cuò)誤信息與若干交互缺陷、--bare編譯下的 Source Map 修正并順帶帶來更小的 map 體積、編譯后塊注釋的格式改進(jìn)以及on/off/yes/no關(guān)鍵字的報(bào)錯(cuò)優(yōu)化。讀完本文你將理解這些修復(fù)背后的詞法、語法樹與源碼映射機(jī)制并能對(duì)照 src/ 下的編譯器源碼定位每一處改動(dòng)的實(shí)現(xiàn)細(xì)節(jié)。版本背景與發(fā)布信息發(fā)布日期2015-05-27版本號(hào)1.9.3上一個(gè)版本1.9.2倉庫中每個(gè)版本變更日志的頭部都通過releaseHeader函數(shù)統(tǒng)一生成發(fā)布信息參見 0.1.0.md 等全部 changelog 文件releaseHeader(2015-05-27, 1.9.3, 1.9.2)該函數(shù)聲明了發(fā)布日期、當(dāng)前版本號(hào)與上一版本號(hào)三個(gè)參數(shù)。1.9.3 屬于 1.9.x 穩(wěn)定分支的小版本全部改動(dòng)均為 bugfix 與錯(cuò)誤處理改進(jìn)未引入新語法特性。修復(fù)一隱式調(diào)用中對(duì)象字面量首鍵的插值Bugfix for interpolation in the first key of an object literal in an implicit call.問題場(chǎng)景CoffeeScript 允許省略調(diào)用括號(hào)implicit call例如console.log foo: #{name}此時(shí)foo: #{name}會(huì)被解析為傳給console.log的對(duì)象字面量。當(dāng)對(duì)象字面量的第一個(gè)鍵本身包含字符串插值interpolation時(shí)詞法分析器Lexer在#與后續(xù)插值表達(dá)式之間切換詞法狀態(tài)的過程中會(huì)出現(xiàn)歧義#既是插值起始標(biāo)記又是行注釋起始標(biāo)記。1.9.3 修復(fù)了在隱式調(diào)用語境下該首鍵插值無法被正確識(shí)別的 bug。底層機(jī)制CoffeeScript 的字符串插值由 src/lexer.coffee 負(fù)責(zé)詞法分析器通過一組按優(yōu)先級(jí)排列的正則嘗試匹配 token見tokenize主循環(huán)約 L65-L89。插值發(fā)生時(shí) Lexer 會(huì)進(jìn)入interpolateString等內(nèi)部狀態(tài)而對(duì)象字面量首鍵位置的 token 類型判定IDENTIFIER、STRING還是其他取決于前序 token 的上下文。從源碼結(jié)構(gòu)看詞法分析器使用COFFEE_KEYWORDS與COFFEE_ALIASES判斷標(biāo)識(shí)符是否為關(guān)鍵字見 src/lexer.coffee 中identifierToken相關(guān)邏輯約 L121-L160并在 token 前一個(gè)為關(guān)鍵字時(shí)將prev改寫為IDENTIFIER。本版本修復(fù)的是該判定流程在隱式調(diào)用 對(duì)象首鍵 插值這一組合下的邊界情況確保{ #{key}: value }這類寫法無論位于調(diào)用列表何處都能穩(wěn)定解析。修復(fù)二REPL 錯(cuò)誤信息與交互細(xì)節(jié)Fixed broken error messages in the REPL, as well as a few minor bugs with the REPL.REPL 的實(shí)現(xiàn)位置CoffeeScript 的交互式命令行coffee -i或coffee無參數(shù)進(jìn)入由 src/repl.coffee 實(shí)現(xiàn)。它以 Node.js 內(nèi)置的repl模塊為基礎(chǔ)覆蓋了自定義的eval函數(shù)將 Node REPL 對(duì)輸入包裹的額外括號(hào)剝離/^\(([\s\S]*)\n\)$/m剝離新版 Node REPL 包裹的try { ... } catch結(jié)構(gòu)約 L17-L25通過CoffeeScript.tokens分詞、CoffeeScript.nodes構(gòu)建 AST再以bare: yes編譯為 JavaScript 后在 VM 上下文中執(zhí)行約 L30-L65。錯(cuò)誤信息修復(fù)舊版本中REPL 里出現(xiàn)語法錯(cuò)誤時(shí)由于錯(cuò)誤對(duì)象缺少源碼位置信息打印出的報(bào)錯(cuò)往往無法定位到具體行甚至顯示為空白。1.9.3 引入updateSyntaxError來修正這個(gè)問題——在catch分支中調(diào)用它把源碼文本與行號(hào)補(bǔ)寫進(jìn)錯(cuò)誤對(duì)象catch err # ASTs compile does not add source code information to syntax errors. updateSyntaxError err, input cb errsrc/repl.coffee 約 L66-L69updateSyntaxError定義于 src/helpers.coffee 約 L227 處。當(dāng)錯(cuò)誤對(duì)象已帶位置時(shí)直接返回否則將錯(cuò)誤對(duì)象包裝為帶location數(shù)據(jù)的SyntaxError并把 CoffeeScript 源碼按行保存到錯(cuò)誤的code屬性中。這樣 REPL 拋出的錯(cuò)誤就能被正確格式化并指向具體源碼行與coffee命令行編譯報(bào)錯(cuò)的行為保持一致。其他交互修復(fù)本版本還順帶修復(fù)了 REPL 的幾個(gè)小缺陷主要包括多行輸入處理addMultilineHandler支持Ctrl-V切換多行模式src/repl.coffee與命令歷史持久化addHistory寫入~/.coffee_history約 L129-L167中的邊界問題例如歷史文件截?cái)鄷r(shí)多出的半個(gè)行、首行空記錄等。修復(fù)三--bare編譯下源碼映射Source Map修正Fixed source mappings for tokens at the beginning of lines when compiling with the--bareoption. This has the nice side effect of generating smaller source maps.--bare與源碼映射的關(guān)系默認(rèn)情況下CoffeeScript 編譯產(chǎn)物會(huì)包裹在(function(){ ... }).call(this);的 IIFE 中--bare選項(xiàng)去掉這層包裝直接輸出頂層代碼常用于瀏覽器端直接執(zhí)行或與其他模塊體系配合。這個(gè)差異會(huì)影響生成的 JavaScript 與原始 CoffeeScript 之間的行列對(duì)應(yīng)關(guān)系。修復(fù)內(nèi)容此前使用--bare編譯時(shí)位于輸出行行首的 token的源碼映射source mapping不準(zhǔn)確。原因在于非 bare 模式下包裝函數(shù)代碼本身占據(jù)了若干偏移編譯器據(jù)此對(duì)生成位置做補(bǔ)償而在 bare 模式下沒有這些偏移位于行首的 token 的first_column補(bǔ)償邏輯與實(shí)際生成位置存在偏差。修復(fù)后行首 token 的映射位置被正確記錄。該修復(fù)同時(shí)帶來一個(gè)附帶收益生成的 source map 更小。這是因?yàn)長ineMap中按列存儲(chǔ)映射見 src/sourcemap.litcoffee不再為錯(cuò)誤的列位置重復(fù)寫入冗余的 VLQ 段mappings字符串長度隨之縮短。源碼映射機(jī)制速覽Source Map 模塊位于 src/sourcemap.litcoffeeLineMap保存單行輸出代碼中每個(gè)列位置對(duì)應(yīng)的[sourceLine, sourceColumn]SourceMap由多行LineMap組成提供add登記映射與sourceLocation反查原始位置generate產(chǎn)出 v3 格式的 JSON 對(duì)象mappings字段通過自定義的encodeVlqBase64 VLQ 編碼src/sourcemap.litcoffee生成緊湊字符串。編譯器入口 src/coffeescript.coffee 在options.sourceMap或options.inlineMap時(shí)生成 map并可通過//# sourceMappingURL指令嵌入或外鏈約 L54-L66 與 L167-L176。此外該文件還使用緩存的 source map 對(duì)運(yùn)行時(shí)棧追蹤進(jìn)行反查讓報(bào)錯(cuò)堆棧指向 CoffeeScript 原始源碼約 L308-L315。命令行中使用方式coffee --bare --map file.coffee # 或 coffee -b -m file.coffee修復(fù)四編譯后塊注釋Block Comment的格式改進(jìn)Slight formatting improvement of compiled block comments.CoffeeScript 的塊注釋以### ... ###書寫編譯后轉(zhuǎn)為/* ... */。1.9.3 對(duì)轉(zhuǎn)換后的排版做了小幅改進(jìn)使得多行塊注釋的輸出更加整潔。底層實(shí)現(xiàn)在 src/nodes.coffee 的HereComment類約 L1604-L1636# Comment delimited by ### (becoming /* */). exports.HereComment class HereComment extends Base compileNode: (o) - multiline \n in content # Unindent multiline comments. They will be reindented later. if multiline indent null for line in content.split \n leadingWhitespace /^\s*/.exec(line)[0] if not indent or leadingWhitespace.length indent.length indent leadingWhitespace content content.replace /// \n #{indent} ///g, \n if indent ...該版本改進(jìn)主要體現(xiàn)在縮進(jìn)處理上多行塊注釋先統(tǒng)一去掉公共最小縮進(jìn)編譯時(shí)再按當(dāng)前輸出層級(jí)重新縮進(jìn)同時(shí)保留注釋內(nèi)部的換行結(jié)構(gòu)使/* ... */的生成結(jié)果與源碼縮進(jìn)風(fēng)格保持一致避免輸出中出現(xiàn)多余的空白行或錯(cuò)位縮進(jìn)。修復(fù)五on/off/yes/no的錯(cuò)誤信息優(yōu)化Better error messages foron,off,yesandno.關(guān)鍵字別名機(jī)制CoffeeScript 將yes/no/on/off作為布爾字面量的別名與true/false等價(jià)。這一映射定義在 src/lexer.coffee 的COFFEE_ALIAS_MAP中COFFEE_ALIAS_MAP and : or : || is : isnt : ! not : ! yes : true no : false on : true off : false COFFEE_ALIASES (key for key of COFFEE_ALIAS_MAP) COFFEE_KEYWORDS COFFEE_KEYWORDS.concat COFFEE_ALIASESsrc/lexer.coffee 約 L1241-L1253即COFFEE_KEYWORDS在undefined, Infinity, NaN, then, unless, until, loop, of, by, when的基礎(chǔ)上追加了全部別名。改進(jìn)點(diǎn)由于on、off、yes、no會(huì)被詞法分析器改寫為true/false此前當(dāng)用戶將它們用作變量名或嘗試賦值時(shí)報(bào)錯(cuò)信息往往晦澀難懂例如提示unexpected identifier。1.9.3 改進(jìn)了針對(duì)這四個(gè)詞的錯(cuò)誤信息。詞法層相關(guān)邏輯可見 src/lexer.coffee當(dāng)別名作為標(biāo)識(shí)符出現(xiàn)時(shí)lexer 根據(jù)上下文決定是否將其改寫為關(guān)鍵字identifierToken中COFFEE_KEYWORDS判斷約 L143-L155對(duì)不可賦值名稱的統(tǒng)一判定在isUnassignable中約 L1190-L1198其中對(duì)JS_KEYWORDS/COFFEE_KEYWORDS輸出 keyword xxx cant be assigned、對(duì)保留字輸出 reserved word xxx cant be assigned。優(yōu)化后當(dāng)你寫出以下代碼on 1 # 錯(cuò)誤keyword on cant be assigned yes true # 錯(cuò)誤keyword yes cant be assigned編譯器會(huì)直接指出對(duì)應(yīng)詞屬于 CoffeeScript 關(guān)鍵字/別名并提示其不可賦值或不可作為函數(shù)名使用后者對(duì)應(yīng) src/lexer.coffee 約 L210-L216 中g(shù)et/set被誤用時(shí)的報(bào)錯(cuò)分支采用同樣的明確說明違規(guī)用法的報(bào)錯(cuò)風(fēng)格。如何驗(yàn)證這些修復(fù)使用 REPL 驗(yàn)證錯(cuò)誤信息coffee coffee yes 1 # Error: keyword yes cant be assigned驗(yàn)證 bare 模式 Source Mapcoffee -b -m -c sample.coffee # 生成 sample.js 與 sample.js.map對(duì)比 1.9.2 與 1.9.3 生成的sample.js.map中mappings字段長度可觀察到后者更短且使用瀏覽器 DevTools /source-map庫反查行首 token 時(shí)定位更準(zhǔn)確。驗(yàn)證塊注釋格式### a b ###編譯后輸出/*\n a\n b\n*/縮進(jìn)按公共前綴收斂、輸出層級(jí)重排多行結(jié)構(gòu)得以保留。小結(jié)CoffeeScript 1.9.3 雖然只包含 bugfix但覆蓋了編譯器管線的多個(gè)關(guān)鍵環(huán)節(jié)詞法分析對(duì)象首鍵插值、關(guān)鍵字別名報(bào)錯(cuò)、REPL 運(yùn)行時(shí)錯(cuò)誤信息與交互、代碼生成與源碼映射--bare行首 token 映射、塊注釋排版。這些改動(dòng)共同提升了 1.9.x 分支在真實(shí)工程中的健壯性與可調(diào)試性。相關(guān)實(shí)現(xiàn)均可對(duì)照 src/lexer.coffee、src/repl.coffee、src/helpers.coffee、src/sourcemap.litcoffee 與 src/nodes.coffee 繼續(xù)深入閱讀。贊分享編程語言編譯器【免費(fèi)下載鏈接】coffeescriptUnfancy JavaScript項(xiàng)目地址https://gitcode.com/gh_mirrors/co/coffeescript點(diǎn)擊查看免費(fèi)下載相關(guān)推薦TDesign MiniProgram 1.9.3版本發(fā)布組件優(yōu)化與問題修復(fù)TDesign MiniProgram 1.9.3版本發(fā)布組件優(yōu)化與問題修復(fù) TDesign MiniProgram是騰訊開源的一套小程序組件庫為開發(fā)者提供小程序UI組件前端設(shè)計(jì)系統(tǒng)Node.js 4.8.3 (Maintenance) 發(fā)布詳解全局模塊加載修復(fù)、TLS 段錯(cuò)誤修復(fù)與發(fā)布文檔全解讀Node.js 4.8.3 Maintenance 發(fā)布詳解全局模塊加載修復(fù)、TLS 段錯(cuò)誤修復(fù)與發(fā)布文檔全解讀 Node.js 4.8.3 是 Node.j前端文檔Cookiecutter 2.7.1 發(fā)布解析版本號(hào)誤報(bào)修復(fù)與 CI 并行化改進(jìn)Cookiecutter 2.7.1 發(fā)布解析版本號(hào)誤報(bào)修復(fù)與 CI 并行化改進(jìn) 本篇文章以 Cookiecutter 2.7.1 的官方發(fā)布說明 CHAN開發(fā)工具CLI代碼生成上一篇Persona快速入門指南5個(gè)步驟讓您的網(wǎng)站支持無密碼登錄下一篇Seelen UI 能做什么Windows 10/11 用戶自定義桌面的實(shí)用指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考