詳細程式碼路徑表
本頁包含「症狀 → 從哪個型別進去」；文件路由在索引，唯一實作在共用元件表。
我要改的是……
| 想做的事 | 從這裡進去 |
|---|---|
| 建議清單多／少了某一類項目 | Core/Completion/BuiltInSuggestionCatalog.cs、SqlCompletionCandidates.cs |
| 排名順序不對 | Core/Completion/SuggestionList.cs、SuggestionScore.cs、Core/Matching/FuzzyMatcher.cs |
| 某個位置不該開清單／該開沒開、打完字沒重開 | Core/Completion/SqlCompletionSlot.cs、SqlCompletionPolicy.cs、SqlCompletionContextAnalyzer.cs、SqlCompletionTriggers.cs、Core/Keywords/SqlKeywordPositionAnalyzer.cs、Ssms22/Completion/SqlCompletionReopen.cs |
| 某個位置出現不該有的候選 | Core/Completion/SuggestionContextFilter.cs、Core/Keywords/SqlKeywordPositionExtensions.cs、tools/Generate-Keywords.ps1 的樣板 |
| 換了介面語言某處沒跟著換 | Ssms22/Settings/SqlLanguageSwitch.cs；作法見在地化 |
| SSMS 自己的清單也跟著彈出來 | Ssms22/Settings/NativeMemberList.cs；總開關為何不能關見補全 |
| 提交後寫進去的文字不對 | Core/Completion/SqlInsertionText.cs（規則）、Ssms22/Completion/SqlAsyncCompletionCommitManager.cs（接線） |
INSERT INTO／MERGE INTO／EXEC／ALTER 展開內容不對、蓋錯位置 | Core/Statements/、Ssms22/Completion/SqlCommitExpansions.cs、SqlCommitExpander.cs |
| 關鍵字清單要增刪；某條尾巴之後少字或多字 | tools/Generate-Keywords.ps1（$ClausePhrases）、Core/Keywords/SqlClausePhrase.cs |
| 內建函式、全域變數或型別要增刪 | Core/Keywords/ 底下的三個 Catalog |
| 自動大寫時機 | Core/Keywords/SqlKeywordCase.cs、Ssms22/Editor/SqlKeywordCasing.cs |
| 括號或引號補錯時機、跳不過去 | Core/Pairing/SqlAutoPairAnalyzer.cs、Ssms22/Editor/SqlAutoPairing.cs |
@、@@ 之後列的東西不對 | Core/Completion/SqlScriptVariableSuggestions.cs、SqlExecutedModule.cs、Core/Keywords/SqlGlobalVariableCatalog.cs |
別名. 列的欄位不對 | Core/Parsing/SqlScopeAnalyzer.cs、SqlColumnSourceResolver.cs |
#tmp／@rows 的欄位列不出來或展不開 | Core/Parsing/SqlScriptTableCollector.cs |
| 片段的格式、展開、合併或存檔 | Core/Snippets/DefaultSnippets.json、SqlSnippetExpansion.cs、SqlSnippetMerger.cs、SqlSnippetSerializer.cs |
| 包住選取範圍的清單、縮排或觸發 | Core/Snippets/SqlSnippetSurround.cs、Ssms22/Snippets/SqlSnippetSurroundAction.cs |
SELECT * 展不開、展錯或排版不對 | Core/Wildcards/SqlWildcardAnalyzer.cs、SqlWildcardExpansionText.cs |
| Tab／Shift+Tab 的行為 | Ssms22/Editor/SqlTabCommandHandler.cs |
| 滑鼠停留提示的內容 | Ssms22/QuickInfo/SqlQuickInfoContentBuilder.cs |
| 內建說明認不出、內容不對、與物件誰先 | Core/Keywords/SqlBuiltInDocCatalog.cs、BuiltInDocs/、Ssms22/Editor/SqlBuiltInObjectResolution.cs |
| 參數提示不出現、粗體錯位、刪字或點回括號後不回來、Esc 後又冒出 | Ssms22/Signatures/SqlSignatureHelp.cs、SqlParameterHintKeeper.cs、Core/Completion/SqlCallSignature.cs、SqlParameterHintRevival.cs |
| 浮動預覽的行為或擺放 | Ssms22/Preview/SqlStructurePreview.cs |
| 浮動預覽什麼時候收 | Core/Preview/PreviewLifecycle.cs |
| 浮動預覽的外觀與進出場；停靠的工具窗 | Ssms22/Preview/PreviewSurface.cs；SqlStructureToolWindow.cs |
| 任何自製 UI、顏色、字型或排版 | Ssms22/UI/SqlAssistChrome.cs |
| 按鍵（F12 之類）沒反應／抵達了卻沒開視窗 | Ssms22/Editor/SqlShellCommandFilter.cs／SqlDefinitionOpener.cs |
| Ctrl＋點擊沒有底線或點了沒反應 | Ssms22/Editor/SqlClickNavigator.cs |
| 結果格線右鍵命令或產出的 SQL 不對 | Metadata/ResultGrid/、Ssms22/ResultGrid/ |
| 新增選單項目或鍵繫結後沒生效 | Menus.vsct＋ProvideMenuResource 版號，見平台 |
| F12 開出來的指令碼內容不對 | Metadata/Formatting/SqlObjectScript.cs |
| 新查詢視窗沒有沿用連線 | Ssms22/Connections/SsmsScriptWindow.cs；Search 別台的結果刻意不連（Search/SqlSearchActivation.cs） |
| 換了資料庫，清單還是舊的物件 | Ssms22/Connections/SqlMetadataService.cs、SqlEditorConnectionWatcher.cs |
| 查詢的 SQL、載入分層、連不上時的行為 | Metadata/Querying/SqlMetadataQueries.cs、Metadata/Caching/SqlMetadataCatalog.cs |
| SQL Memory 開不起來、停用後仍擷取、心跳或維護沒跑 | Core/SqlMemory/SqlMemoryRuntime.cs（Ssms22/SqlMemory/SqlMemoryHost.cs 只接線） |
| SQL Memory 清單篩選、分頁、晚到回應或選取還原 | Core/SqlMemory/SqlMemoryBrowserModel.cs |
| 伺服器／資料庫篩選或套用查詢視窗的連線不對 | Core/Connections/SqlConnectionScope.cs；Search 的連線在 Search/SqlSearchCatalogs.cs |
| 大小寫、全字沒作用，或兩個工具窗命中不同 | Core/Matching/TextMatcher.cs；開關在 Ssms22/UI/SqlMatchToggles.cs |
| 多選勾不起來、勾錯列、選取工具列不出現 | Ssms22/UI/SqlCardSelection.cs、SqlCardList.cs、SqlSelectionBar.cs |
| 批次複製的欄位、順序或「全部符合」讀不完 | Core/SqlMemory/SqlMemoryCopy.cs、SqlMemoryBulk.cs、Ssms22/SqlMemory/SqlMemoryBrowser.cs；Search 的欄位在 Search/SqlSearchRow.cs |
| 批次刪除的分批、取消或衝突 | Core/SqlMemory/SqlMemoryDeletion.cs、Ssms22/SqlMemory/SqlMemoryItemCommands.cs |
| 存檔後歷程掛錯文件、選取執行記錄的文字不對 | SqlDocumentIdentity.cs、SqlSelectionText.cs、Ssms22/SqlMemory/SqlCaptureTracker.cs |
| SQL Memory 的 SQL、交易或索引 | SqlMemory.Sqlite/Sqlite*Store.cs（連線與 schema 在 SqliteDatabase.cs） |
| 指令碼整段變成註解（缺定義、缺欄位） | Metadata/Model/SqlObjectStructure.cs 的 CanBuildExecutableScript |
| 通知島錨錯視窗、不出現或提醒按鈕沒反應 | Ssms22/Notifications/，分工見通知呈現 |
測試
SqlAssist.SqlMemory.Sqlite.Tests 驗真實 SQLite 與隔離層；SqlAssist.Ssms22.Tests 只連結純 WPF 控制項做渲染測試，不載入 SSMS。 游標位置的測試寫法見 tests/SqlAssist.Core.Tests/SqlWithCaret.cs。