vscode 本身无 ai 编程能力，所有辅助功能均依赖插件，但需满足权限（github 账户登录且未被禁用）、语言模式（支持后缀如 .js/.ts/.py）、光标位置（代码行尾且非字符串/注释内）三大硬条件，缺一不可。
VSCode 本身不带 AI 编程能力，所有辅助编写功能都依赖插件，但不是装了就能用——多数人卡在权限、网络、语言模式这三关上。
GitHub Copilot 插件装完没反应？先查这三个硬条件
很多人点开 Copilot: Toggle Copilot 显示已启用，但右下角没图标、敲代码没补全。这不是插件坏了，而是没过基础校验：
- 必须用个人 GitHub 账户登录（不能走企业 SSO 页面），且该账户在 GitHub Org 中未被管理员禁用 Copilot 权限
- 当前文件后缀得是
.js、.ts、.py等 Copilot 支持的语言；.txt或无后缀文件不会触发 - 光标位置必须在可编辑的代码行尾——不能在字符串里、注释末尾、也不能处于多行选中状态
另外，editor.suggestOnTriggerCharacters 必须为 true（默认就是），否则输入 . 或 ( 不会拉建议。
离线环境装 Volar / DevChat / GLM-4.7-Flash 容易静默失败
离线装 Vue 或 AI 插件，90% 的“装了没效果”是因为漏掉了语言服务器（LSP）二进制文件或版本不匹配：
- Volar 要求 VSCode ≥ 1.77，且架构必须一致：arm64 Mac 不能装 x64 版本的
volarjs.volar-*.vsix - 拖拽安装没反应？先确认窗口有焦点（任务栏图标高亮）、已打开一个文件夹（哪怕空的）、拖的是原始
.vsix（不是浏览器自动改名的.vsix.zip） - 装完 .vue 文件没高亮/跳转？说明
server/子目录和对应平台的volar-server-darwin-arm64等二进制没同步过去——不能只拷.vsix，得整个插件目录复制到$HOME/.vscode/extensions/
命令行安装插件失败，别急着重试，先分清两个错误
command not found: code 和 not compatible with Code 常被混为一谈，但解决路径完全不同：
-
command not found: code→ 是 CLI 没注册，按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH执行即可 -
not compatible with Code→ 是.vsix的engines.vscode字段不满足，比如本地 VSCode 是1.84.3，但插件要求^1.85.0，就得降级下载volar-1.13.x
验证方式：用 unzip -p xxx.vsix extension/package.json | grep engines（macOS/Linux）或 7-Zip 打开查看。
AI 插件对本地环境有隐性依赖
GLM-4.7-Flash、DevChat 这类本地模型插件，表面只装 VSCode 插件，实际还依赖 Python 和 Git：
- 必须已安装 Python 3.8+，且能被 VSCode 正确识别（部分插件会调用
python -m pip安装依赖） - Git 不仅用于克隆模型权重，有些插件启动时会执行
git rev-parse --short HEAD校验版本，没装 Git 会卡住或报错 - 内存低于 16GB 时，GLM-4.7-Flash 加载模型可能超时，日志里只显示 “initializing…” 无后续，需手动调低模型加载参数
真正麻烦的不是装不上，而是装上了但某条链路断在看不见的地方——比如 LSP 服务没下载完、Python 环境没激活、Git 路径没加进系统变量。这些环节都不报红错，只让功能静默失效。
