前往
大廳
主題

(三)了解腳本 - 2.Script Assist

恐龍 | 2026-01-15 15:17:40 | 巴幣 0 | 人氣 24

所有教學目錄請點擊這裡
圖片皆來自官方教學手冊
圖片皆來自官方教學手冊
圖片皆來自官方教學手冊
註:教學圖稍多,請注意流量

等級2,閱讀時間10分鐘
===================================
一、大綱
===================================
MSW的腳本編輯器提供多種功能,幫你快狠準的摳頂撰寫程式碼。Script Assist 是這些功能的統稱。本章節將帶你逐一了腳本輔助的各項功能。

===================================
二、導覽
===================================
此功能可協助你快速且輕鬆地移動到腳本中的指定位置。
1.尋找參照:此功能可讓你輕鬆找到符號的所有參照。在符號的右鍵選單中點擊 Show References,即可開啟 References 視窗。Find References 會在整個專案中搜尋目前符號的所有參照位置。


2.前往定義:在符號的右鍵選單中點擊 Go to Definition,即可直接跳轉至該符號的定義位置。


3.返回 / 前進:使用以下快捷鍵,可在已記錄的位置之間來回移動。
按下 Ctrl(L) + -,可移動到上一個位置;
按下 Ctrl(L) + =,可從上一個位置移動到最近的位置


===================================
三、程式碼檢查
===================================
Code Inspection 會檢查程式碼,找出工程師未察覺的錯誤,提前預防程式出錯。下圖所示,當發生錯誤時會顯示底線,將滑鼠移到上方即可看到詳細說明,可作為快速修正錯誤的參考。


可偵測的錯誤類型如下:
錯誤 說明
UnavailableMethodCall 使用了 Dot 呼叫方式,但建議使用 Colon
TooManyParameter 傳入的參數數量超過需求
ParameterTypeMismatch 參數型態與需求型態不符
AssignTypeMismatch 指派的值型別與變數型別不符
TableKeyTypeMismatch Table 的 Key 型態不符
NotRecommendedAssignment 使用了不建議的指定方式
ReturnValueFromVoidFunction 在無回傳值的函式中使用 return
AssignToReadonlyProperty 指定的對象為唯讀
IntroduceGlobalVariable 宣告了全域變數
ObsoleteAPIUsed 使用已停用的 API,建議改用其他 API
UnbalancedAssignment 指定敘述左右長度不一致
UnreachableCode 無法執行的程式碼
UnresolvedSymbol 找不到符號
UnresolvedMember 找不到成員
UnresolvedFunction 找不到函式
DuplicateLocal 重複宣告區域變數
AnnotationNotFound 找不到註解
AnnotationTypeNotFound 找不到註解的型態
ReturnTypeMismatch 回傳型不一致
NotEnoughArgument 傳入的參數數量不足
DuplicateFunction 重複定義函式

===================================
四、標示
===================================
透過文字顏色與背景顏色的方式,讓程式碼更容易辨識。
1.符號參照標示:選取某個符號時,所有參照該符號的位置都會被反白標示。如下圖所示,其他參照相同符號的地方也會顯示背景顏色。




2.語法標示:用來強調語法結構。系統會分析程式碼內容:如果符號是個變數,會用色號#1F377F標示;字串使用#F17D80標示;註解則使用#648064


除了上述範例外,還提供多種語法標示效果。
3.關聯符號標示:此功能會標示彼此相關的關鍵字。例如選取 if 時,與其搭配使用的 then 與 end 也會一併被標示。



===================================
五、快速資訊
===================================
在你將滑鼠停留在函式、變數或參數上時,即時顯示相關的程式碼資訊。



===================================
六、程式碼補完
===================================
根據目前的程式碼情境,建議可使用的符號。使用上下方向鍵選擇項目,按 Enter 或 Tab 即可插入。


若要再次顯示選單,請按 Ctrl + 空白鍵。

自動補完功能也會提供你已宣告的函式與變數名稱,能有效避免打錯字並能提升效率。

===================================
七、函式參數輔助
===================================
幫助你在填入函式所需參數時,顯示參數順序及型態



如果想再次打開提醒,按下Ctrl + Shift + 空白鍵

===================================
八、註釋
===================================
強化腳本輔助功能。

===================================
九、程式碼自動生成
===================================
可自動加入常用的程式碼片段,加快撰寫速度。
自動括號補齊:自動補齊成對的括號。
自動敘述補齊:在撰寫程式碼選擇並按下 Enter 時,會自動補齊其餘的程式碼。


===================================
十、註解快捷鍵
===================================
你可以使用鍵盤快捷鍵,快速對程式碼加入註解或移除註解。
1.單行註解:按 Ctrl(L) + / 可對目前游標所在行,或選取的多行加入註解。再次按下 Ctrl(L) + / 可取消註解。


2.區塊註解:按 Ctrl(L) + Shift(L) + / 可對選取的程式碼加入區塊註解。可只套用在單行的一部分。再次按下可解除區塊註解。


===================================
十、其他便利功能
===================================
以下是你可以使用的一些額外便利功能。
1.透明化:按左Ctrl可讓輔助功能變為透明,方便檢視程式碼本身。


2.複製:按左Ctrl+ D 可複製選取的行或區塊。若是複製單行:內容會出現在下一行;複製區塊則內容會緊接在選取區塊之後



完整快捷鍵清單請點此

===================================
十一、偏好設定
===================================
你可以在Edit - Preferences 調整腳本輔助設定。


完成設定後,請按下 [Save] 儲存變更。
設定項目的說明如下:
項目 細項 說明
Code Completion Enable Code Completion 啟用程式碼補完
Signature Helper Enable Signature Helper 啟用函式參數輔助
Code Generation Enable AutoBracketCompletion 啟用自動括號補齊
Enable AutoStatementPair 啟用自動敘述補齊
Code Inspection Enable Code Inspection 啟用程式碼檢查
Error Level 設定各錯誤等級是否啟用
Warning Level 設定各警告等級是否啟用
Info Level 設定各資訊等級是否啟用
Highlighting Syntax Highlighting 啟用語法標示,可自訂顏色
Symbol Highlighting 啟用符號標示,可自訂顏色
Related Token Highlighting 啟用關聯符號標示,可自訂顏色

相關創作

更多創作