VSCode自动补全不生效如何解决？

Question

在使用 VSCode 进行开发时，常有用户反馈 JavaScript 或 TypeScript 文件中智能补全功能失效，表现为输入属性或方法时无提示、补全延迟或仅显示通用建议。此问题多由语言服务未正确启动、插件冲突、工作区设置覆盖或 `typescript` 内置插件被禁用导致。此外，项目过大或 `node_modules` 未正确索引也可能影响补全性能。需检查是否启用了正确的语言服务器（如 TypeScript Server）、确认 `js/ts` 语义支持是否运行正常，并排除第三方扩展干扰。

Answer 1

1. 常见现象与初步排查

在使用 VSCode 开发 JavaScript 或 TypeScript 项目时，用户常反馈智能补全功能异常。典型表现为：

• 输入对象属性或方法时无提示
• 补全响应延迟严重（>2秒）
• 仅显示通用单词建议而非语义化补全
• Hover 查看类型信息失败

这些问题通常不是编辑器本身缺陷，而是语言服务层出现问题。VSCode 使用内置的 TypeScript Language Server 提供 JS/TS 智能感知能力，若该服务未启动或异常，将直接影响开发体验。

2. 核心机制解析：TypeScript 语言服务器工作原理

VSCode 的 JS/TS 智能补全依赖于 tsserver 进程，其运行流程如下：

graph TD
    A[打开 .ts/.js 文件] --> B{是否启用 TS Server?}
    B -- 是 --> C[启动 tsserver 子进程]
    C --> D[解析 AST & 构建符号表]
    D --> E[监听文件变化]
    E --> F[提供补全、跳转、诊断等服务]
    B -- 否 --> G[降级为基本文本补全]

当 tsserver 无法加载项目上下文，或被第三方插件阻断时，语义支持即失效。

3. 排查路径与诊断工具

可通过以下方式验证语言服务器状态：

1. 按下 <kbd>Ctrl+Shift+P</kbd> 输入 “TypeScript: Open TS Server Log” 查看日志
2. 执行 “Developer: Reload Window” 观察控制台输出
3. 使用 “TypeScript: Restart TS Server” 强制重启服务
4. 检查输出面板中 “TypeScript” 通道是否有错误堆栈

4. 配置冲突与插件干扰分析

常见配置项可能覆盖默认行为：

配置项	影响范围	风险值
typescript.suggest.enabled	关闭 TS 补全	高
javascript.suggest.autoImports	禁用自动导入提示	中
typescript.preferences.includePackageJsonAutoImports	影响 node_modules 索引	中
extensions.ignoreRecommendations	可能导致关键插件未启用	高

同时，部分 LSP 插件（如 Volar、Flow Language Support）可能抢占语言服务，需确认是否冲突。

5. 大型项目性能优化策略

对于包含大量文件或复杂依赖的项目，可采取以下措施提升索引效率：

{
  "typescript.tsserver.maxTsServerMemory": 8192,
  "typescript.tsserver.trace": "verbose",
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true
  },
  "typescript.preferences.includeInlayParameterNameHints": "literals"
}

此外，在 jsconfig.json 或 tsconfig.json 中明确指定 include 范围，避免全量扫描：

{
  "compilerOptions": {
    "module": "esnext",
    "target": "es2020"
  },
  "include": [
    "src/**/*"
  ]
}

6. 内置插件管理与恢复流程

确保 “TypeScript and JavaScript Language Features” 插件处于启用状态：

1. 进入 Extensions 面板（<kbd>Ctrl+Shift+X</kbd>）
2. 搜索 @builtin typescript
3. 确认 “TypeScript Language Basics” 已启用
4. 如被禁用，点击启用并重启编辑器

可通过命令行验证：

code --list-extensions | grep -i typescript