Snippet Craft
一個VS Code程式碼片段管理外掛
功能
建立和插入程式碼片段
在編輯器區域右鍵選單中點選插入Snippet,或在程式碼片段檢視中點選條目,則會將程式碼片段插入到當前啟用文件的游標位置。
程式碼片段編輯
程式碼片段在左側欄中,根據建立時的檔案內容型別,分組顯示程式碼片段,可編輯已有的程式碼片段。
程式碼片段預覽
滑鼠移動到程式碼片段條目上時,顯示tooltip預覽
預設對映
對映是插入程式碼片段時,自動替換的變數。
程式碼片段中透過設定佔位符${VAR_NAME}
,在插入程式碼片段時,將自動替換為全域性變數中的值。可用的對映如下表:
類別 | 變數 | 描述 |
---|---|---|
檔案和編輯器相關 | TM_SELECTED_TEXT | 當前選定的文字或空字串 |
TM_CURRENT_LINE | 當前行的內容 | |
TM_CURRENT_WORD | 游標下的單詞或空字串的內容 | |
TM_LINE_INDEX | 基於零索引的行號 | |
TM_LINE_NUMBER | 基於一個索引的行號 | |
TM_FILENAME | 當前文件的檔名 | |
TM_FILENAME_BASE | 當前文件的檔名(不含副檔名) | |
TM_DIRECTORY | 當前文件的目錄 | |
TM_FILEPATH | 當前文件的完整檔案路徑 | |
RELATIVE_FILEPATH | 當前文件的相對檔案路徑(相對於開啟的工作區或資料夾) | |
CLIPBOARD | 剪貼簿的內容 | |
WORKSPACE_NAME | 開啟的工作區或資料夾的名稱 | |
WORKSPACE_FOLDER | 開啟的工作區或資料夾的路徑 | |
CURSOR_INDEX | 基於零索引的遊標編號 | |
CURSOR_NUMBER | 基於單索引的遊標編號 | |
時間相關 | CURRENT_YEAR | 本年度 |
CURRENT_YEAR_SHORT | 當年的最後兩位數字 | |
CURRENT_MONTH | 兩位數字的月份(例如“02”) | |
CURRENT_MONTH_NAME | 月份的全名(例如“July”) | |
CURRENT_MONTH_NAME_SHORT | 月份的簡短名稱(例如“Jul”) | |
CURRENT_DATE | 以兩位數字表示的月份中的某一天(例如“08”) | |
CURRENT_DAY_NAME | 日期的名稱(例如“星期一”) | |
CURRENT_DAY_NAME_SHORT | 當天的簡短名稱(例如“Mon”) | |
CURRENT_HOUR24 | 小時制格式的當前小時 | |
CURRENT_MINUTE | 兩位數的當前分鐘數 | |
CURRENT_SECOND | 當前秒數為兩位數 | |
CURRENT_SECONDS_UNIX | 自 Unix 紀元以來的秒數 | |
CURRENT_TIMEZONE_OFFSET | 當前 UTC 時區偏移量為 +HH 或者 -HH (例如“-07:00”) |
|
其他 | RANDOM6 | 6 個隨機 Base-10 數字 |
RANDOM_HEX6 | 6 個隨機 Base-16 數字 | |
UUID | 第四版UUID |
注意:當自定義對映值未設定或者不可用時,將直接顯示變數佔位符
自定義對映
擴充套件初始化時,插入了三個常用的自定義對映,你可以自由更改或新增自定義對映。
示例:
程式碼片段內容
value of 'AUTHOR' is: ${AUTHOR}
value of 'COMPANY' is: ${COMPANY}
value of 'MAIL' is: ${MAIL}
value of 'FOOBAR' (non-exist) is: ${FOOBAR}
插入程式碼片段後,顯示如下:
value of 'AUTHOR' is: 林曉lx
value of 'COMPANY' is: my-company
value of 'MAIL' is: jevonsflash@qq.com
value of 'FOOBAR' (non-exist) is: ${FOOBAR}
與自定義對映一樣,當預設對映值未設定或者不可用時,將直接顯示變數佔位符
自動完成
程式碼片段可在編輯器中顯示自動提示和補全內容。
快速開始
透過點選上方橫幅上的安裝按鈕安裝 Snippet Craft,或在 VS Code 的擴充套件側邊欄中搜尋 Snippet Craft 進行安裝。
更新內容
Date | Version | Content |
---|---|---|
V0.1.0 | 2024-8-22 | 初始版本 |
Todo
作者資訊
作者:林小
郵箱:jevonsflash@qq.com
License
The MIT License (MIT)
專案地址
Github:snippet-craft