四兩撥千斤——你不知道的VScode編碼TypeScript的技巧


轉載請注明出處:葡萄城官網,葡萄城為開發者提供專業的開發工具、解決方案和服務,賦能開發者。

原文參考:https://blog.bitsrc

如果你體驗過JAVA這種強類型語言帶來的便利,包括其豐富的類型變量、抽象與接口,轉而使用JavaScript一定會覺得不夠滿意。尤其是JavaScript聲明的變量Number可以輕而易舉的分配給String,IDE如何執行任何類型的IntelliSense都讓人十分困擾。

面對這個技術障礙,我們就無法忽視TypeScript帶來的便利。相比較於JavaScript,最為明顯的一點就是我們可以賦予IDE實際使用的能力, 本文將要介紹一些TypeScript的編碼技巧,幫助您更加快速高效的進行工作。

創建自定義代碼段

獲取默認的代碼段以及自定義代碼段是VScode的IntelliSense功能的重要部分,代碼片可以大幅縮減編寫代碼的時間,只需要記住使用前綴,用什么觸發就可以。

通過從命令菜單中選擇“插入代碼段”,即可查看,該列表內容豐富,能在日常工作提供很大幫助。

 

另一個重要內容是添加自定義代碼段。

使用方法:選擇“文件” > “首選項”下的“用戶代碼段”(在macOS上為“代碼” > “首選項”),選擇代碼段可訪問的語言,或是全局語言。

添加自定義代碼段,只需要在文件內添加一個JSON定義。

 

新的snippets文件就新建在了項目文件夾中,具有自定義擴展名,支持JSON的內聯注釋。

需要定義的內容包括:

l   名稱,如果沒有描述將作為IntelliSense下拉列表的一部分

l   范圍,默認為全句代碼段

l   前綴,作為觸發片段的單詞,可以定義為字符串組或值

l   主體,包含代碼行列表,可以添加VScode標記,使用TAB移動

l   描述,此項為可選內容,如果不使用則在IntelliSense下拉菜單中列出的項目出現時顯示其名稱

上面的示例中我們創建了一個自定義代碼段,當開始編寫“ mylog”就會觸發該代碼段。有人可能對代碼中console.log有疑問,但要注意還有一個預定義的變量:TM_SELECTED_TEXT,它引用當前選定的文本。因此,如果我們在選擇代碼時手動觸發此代碼段,它將將該選擇封裝在一條console.log語句中。

這里整理了一些開發中常用代碼段的預定義變量:

l   TM_SELECTED_TEXT 當前選擇的文本或空字符串

l   TM_CURRENT_LINE 當前行的內容

l   TM_CURRENT_WORD 光標下的單詞內容或空字符串

l   TM_LINE_INDEX 基於零索引的行號

l   TM_LINE_NUMBER 基於一索引的行號

l   TM_FILENAME 當前文檔的文件名

l   TM_FILENAME_BASE 當前文檔的文件名,不帶擴展名

l   TM_DIRECTORY 當前文件的目錄

l   TM_FILEPATH 當前文檔的完整文件路徑

l   CLIPBOARD 剪貼板中的內容

l   WORKSPACE_NAME 打開的工作空間或文件夾的名稱

 

日期和時間的引用:

l   CURRENT_YEAR 本年度

l   CURRENT_YEAR_SHORT 本年度的最后兩位數字

l   CURRENT_MONTH 以兩位數表示的月份(例如“ 02”)

l   CURRENT_MONTH_NAME 月的全名(例如“七月”)

l   CURRENT_MONTH_NAME_SHORT 該月的簡稱(例如“ Jul”)

l   CURRENT_DATE 一個月中的某天

l   CURRENT_DAY_NAME 一天的名稱(例如“周一”)

l   CURRENT_DAY_NAME_SHORT 一天的簡稱(例如“ Mon”)

l   CURRENT_HOUR 當前小時(24小時制)

l   CURRENT_MINUTE 當前分鍾

l   CURRENT_SECOND 當前秒

l   CURRENT_SECONDS_UNIX 自Unix時代以來的秒數

動態添加有效的注釋標簽:

l   BLOCK_COMMENT_START輸出示例:JavaScript/*或HTML<!--

l   BLOCK_COMMENT_END輸出示例:JavaScript*/或HTML-->

l   LINE_COMMENT 示例輸出:在JavaScript中 //

舉一些例子加以說明:

 

 

通過“ doc”,創建注釋塊,光標定位在的$1位置,如果在其中寫內容並按TAB鍵,將跳轉到position $2。

最終結果如下所示:

 

自定義TypeScript格式

根據個人風格和編碼習慣自定義自己的編碼格式

在設置窗口中,鍵入“ typescript.formatting ”, TypeScript提供了24種格式化選項。

 

可選擇的范圍包括:在打開和關閉字符串括號后添加空格,在函數的新行添加括號,處理分號(可選擇忽略,添加缺失的括號或自動將其全部刪除)。

通過此列表,我們可以自定義VSCode,使代碼風格更符合個人編碼習慣。完成后,通過選擇命令面板上的“設置文檔格式”選項生效。

易重構性強

 

在大型項目上進行重構尤其麻煩,進行簡單的更改(例如,將類定義從一個文件夾移動到另一個文件夾)會影響很多文件。

而VSCode提供了一組非常好用且無需進行任何額外的擴展的功能。

1.重命名現有符號

通過簡單的Search&Replace可以在代碼中重命名變量或類名,除非名稱是其他實體的一部分,例如命名類Car,然后將其oCar作為實例的變量。如果僅打算重命名實際的類,則會導致一些問題。

VSCode簡化了很多工作,我們要做的只是選中要重命名的實體之一,然后按F2(或右鍵單擊它並選擇“重命名符號”,mac的操作有些不同)。選擇新名稱,該過程中使用的任何地方(包括定義,如果最初未單擊它的話)都將被正確重命名。

 

2.抽象的構建

如果不止一次使用,需要對其進行抽象。常見的重構技術是提取邏輯成為如一個函數或一個方法。

通過選擇要重復使用的代碼並單擊其旁邊的燈泡進行抽象。例如以下代碼,需要提取最后兩行:

  

選擇提取在全局范圍生效,輸入新的函數名,將獲得以下內容:

 

同時countCharacters功能需要一些修飾,在更復雜的用例下好處也很明顯。

燈泡的菜單選項是上下文感知的,如果我們正在使用類,則還可以選擇將代碼提取為新方法,或將類型轉換為接口,以及將單個值轉換為常量。

3.簡化功能簽名

將過多參數通過將對象分解添加到混合中進行簡化:

選擇所有參數,然后單擊燈泡,選擇“將參數轉換為變形的對象”

 

進一步優化,打開類型聲明,然后將其轉換為外部類型,可以再次選擇類型定義

 

點擊“提取到類型別名”將詢問新的類型名稱,它將創建該名稱並將其放置在函數的簽名上

 

進一步簡化此代碼

 

保存文件后自動操作

我們都經歷過將代碼提交到存儲庫之前忘記格式化文件或運行linter了,而 VSCode允許我們定義在文件保存后立即執行的預設操作,這樣就避免了開發的的疏漏。

設置過程是編輯settings.json器編輯文件,添加editor.codeActionsOnSave就可以在保存文件后設置要執行的操作列表,包括運行ESLint或添加缺少的導入等操作。

可以將其設置為如下數組:

“ editor.codeActionsOnSave”:[“ source.fixAll.eslint”,“ source.addMissingImports”]

同時,如果我們希望在保存文件時自動添加前面提到的格式化選項(而不是手動格式化文檔),則可以將以下條目添加到我們的settings.json:

 

"editor.formatOnSave": true

例如,實現將分號設置為自動插入。

CodeLens計數器

VSL默認情況下不會激活CodeLens,對於大型代碼庫這將非常不便,這里將提供一些重構思路:

通過啟用列出類,函數,類型和其他構造的實現和引用的計數器的功能,有小標記。

要啟用此功能,只需在設置屏幕上查找單詞“ CodeLens”。啟用所有計數器。

將得到以下內容:

 

“3 references” 和“1 reference”是由VSCode直接添加的,一旦單擊它們,將獲得引用構造的代碼的擴展視圖(在此示例中為定義的類型):

 

總結:本文總結的這些TypeScript的編碼技巧可以有效的提升您的編碼效率,今后我們將會為您帶來更多相關技巧,助力開發者。

拓展閱讀:

如何用TypeScript玩轉在線表格單元格設置,一文帶你了解如何用Visual Studio Code+TypeScript完成自定義顏色選擇器單元格


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM