圖片皆來自官方教學手冊
圖片皆來自官方教學手冊
圖片皆來自官方教學手冊
註:教學圖稍多,請注意流量
等級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 + 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 |
啟用關聯符號標示,可自訂顏色 |