VSCode中.js/.ts文件无法自动补全ES新特性方法求解决方案

现象与环境 #

• 自动补全无法识别str.at()（ES2022）、str.replaceAll()（ES2021）、arr.findLast()（ES2023）等ES新特性方法，.js和.ts文件均存在该问题。
• Node、VSCode已更新至最新版本，安装了IntelliCode、JavaScript and TypeScript Nightly、ES7+ React/Redux/React-Native snippets等扩展。

当前settings.json配置片段 #

...
"emmet.syntaxProfiles": { "javascript": "jsx" },
"emmet.includeLanguages": {
        "javascript": "javascriptreact",
        "typescript": "typescriptreact",
        "ejs": "html",
        "django-html": "html"
},
"emmet.triggerExpansionOnTab": true,   
"editor.defaultFormatter": "esbenp.prettier-vscode",     
"javascript.suggest.completeFunctionCalls": true,
"javascript.suggest.autoImports": true,
"javascript.updateImportsOnFileMove.enabled": "always",
"javascript.suggestionActions.enabled": true,
"javascript.referencesCodeLens.enabled": true,
    
"typescript.suggest.completeFunctionCalls": true,
"typescript.suggestionActions.enabled": true,
"typescript.updateImportsOnFileMove.enabled": "always",
"typescript.suggest.autoImports": true,
"typescript.referencesCodeLens.enabled": true,
    
"code-runner.saveAllFilesBeforeRun": true,
"code-runner.ignoreSelection": true,
//"code-runner.runInTerminal": true, //only 2 Python
"code-runner.clearPreviousOutput": true,
"code-runner.executorMap": {
            "javascript": "node",
            "typescript": "npx ts-node --files", //2 local install
            //"typescript": "ts-node --files", //2 global install
    
            "python": "set PYTHONIOENCODING=utf8 && venv\\Scripts\\python.exe -u", //code-runner exec python of venv
            "bat": "cmd /c"

 },
 ...

原因分析 #

核心原因是VSCode的JavaScript/TypeScript语言服务未启用对应ES版本的语法支持：

1. 项目缺少jsconfig.json或tsconfig.json，语言服务默认使用较低ES版本的类型定义，无法识别新特性。
2. 即使安装了Nightly扩展，未正确配置语言服务版本或目标ES版本，导致新特性未被纳入补全范围。
3. 部分扩展可能干扰语言服务的补全逻辑，屏蔽了新特性方法的提示。

修复步骤 #

1. 添加/修改项目配置文件 #

• JavaScript项目：在项目根目录创建jsconfig.json，指定目标ES版本：

  {
    "compilerOptions": {
      "target": "ES2023",
      "module": "ESNext",
      "checkJs": true
    },
    "include": ["src/**/*"]
  }
  

• TypeScript项目：确保tsconfig.json的compilerOptions.target设置为ES2023或更高：

  {
    "compilerOptions": {
      "target": "ES2023",
      "module": "ESNext",
      "strict": true
    },
    "include": ["src/**/*"]
  }
  

2. 配置语言服务版本 #

• 打开VSCode设置，搜索typescript.tsdk，选择JavaScript and TypeScript Nightly提供的SDK路径；或在settings.json中添加：

  "typescript.tsdk": "./node_modules/typescript/lib"
  

  需先在项目本地安装最新版TypeScript：npm install typescript@latest --save-dev

3. 全局设置ES目标版本 #

针对无配置文件的项目，在settings.json中添加：

"javascript.implicitProjectConfig.target": "ES2023",
"typescript.implicitProjectConfig.target": "ES2023"

4. 排查冲突扩展 #

暂时禁用ES7+ React/Redux/React-Native snippets等扩展，测试补全是否恢复。若恢复，逐一排查冲突扩展并调整其配置。

5. 重启语言服务 #

按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），执行TypeScript: Restart TS Server命令，让配置生效。

内容的提问来源于stack exchange，提问作者M.F