windsurf是离线补全第一选择，因其免费、支持离线轻量模型、原生走vscode的inlinesuggest通道，不抢焦点、不弹窗、不打断输入流，且可在无网环境（如内网开发机、竞赛用机）开箱即用。
Windsurf 为什么是离线补全第一选择
它免费、支持离线轻量模型、原生走 VSCode 的 editor.inlineSuggest 通道，不抢焦点、不弹窗、不打断输入流——这点比 Copilot 实际体验更稳。Copilot 必须联网+登录 GitHub+订阅，而 Windsurf 在没网的内网开发机、客户现场笔记本、竞赛用机上开箱即用。
安装后只需确认两件事：
-
editor.inlineSuggest.enabled是true（VSCode 1.86+ 默认开启） - 关掉其他插件的 inline 模式，比如设
github.copilot.inlineSuggest.enable为false，避免建议打架 - 在 TS/JS 文件里敲
fetch，看行尾是否立刻浮现带参数签名的完整调用建议（来自本地模型，非网络请求）
别让 TabNine 和 Copilot 同时开机
两者都监听 onType 事件、劫持 editor.suggest 面板，冲突后典型表现是：输入 use 弹出空白建议框，或按 Ctrl+Space 卡死 2 秒。它们底层都依赖本地模型推理，同时运行容易吃光内存（尤其 M1/M2 Mac）。
只留一个主力：
- 前端项目优先选
Copilot（对 React/Vue/TS 生态理解更深） - 纯 JS/Python 小项目可换
TabNine（离线可用，隐私敏感场景更稳） - 务必关掉另一个的自动触发：
tabnine.experimentalAutoImports或github.copilot.inlineSuggest.enable
离线安装 .vsix 插件时最容易漏掉的依赖
很多插件（比如 ms-python.python）本身不报错，但关键功能失效——比如 Python 补全不出现、调试器启动失败。根本原因不是插件没装好，而是它的依赖没一起装。
常见被忽略的依赖项：
-
ms-vscode.vscode-typescript-next（TypeScript 语言服务，影响 TS/JS 补全精度） -
esbenp.prettier-vscode（Prettier 插件，部分补全逻辑依赖其格式化反馈） -
dbaeumer.vscode-eslint（ESLint 插件，路径别名补全由它驱动，不是 TS 自己干的）
验证方式：打开命令面板 → 运行 Developer: Toggle Developer Tools → 查 Console 是否有 Extension host terminated 或 Failed to activate extension 报错。
补全失效？先查 typescript.tsdk 路径配没配对
TypeScript 补全严重依赖工作区实际使用的 tsc 版本。全局装了 typescript@5.3，项目却用 4.9，VS Code 拿错语言服务，结果 Array.prototype.map 能补全，但自定义 MyContext 类型完全不出现。
正确做法：
- 打开命令面板 → 运行
TypeScript: Select TypeScript Version - 选
Use Workspace Version（不是 global） - 检查底部状态栏是否显示 “Workspace version” —— 如果显示的是 “Global version”，说明配置没生效
- 手动在
.vscode/settings.json加："typescript.tsdk": "./node_modules/typescript/lib"
这个路径一旦写错或指向不存在的目录，interface 补全会直接消失，且无任何提示。
