如何在Visual Studio Code中为pdf.js启用自动补全功能？

问题场景 #

我执行了以下操作：

npm init -y
npm install pdfjs-dist

随后在Visual Studio Code中创建了JavaScript文件test.js，内容如下：

const pdfjsLib = require("pdfjs-dist/build/pdf.js");

const pdfPath = "test.pdf";
const doc = await pdfjsLib.getDocument(pdfPath).promise;

输入await pdfjsLib.getDocument(pdfPath).时没有出现自动补全，这是预期行为吗？该如何启用此类自动补全？

解决方案 #

这不是预期行为，可通过以下方式修复：

• 安装类型定义包
  pdfjs-dist的CommonJS导出未携带完整类型信息，VS Code的IntelliSense需要依赖@types/pdfjs-dist识别API结构，执行命令安装：

  npm install @types/pdfjs-dist --save-dev
  

• 启用VS Code的JavaScript类型检查
  在项目根目录的.vscode/settings.json中添加配置，确保补全功能正常：

  {
    "javascript.implicitProjectConfig.checkJs": true,
    "javascript.suggest.completeFunctionCalls": true
  }
  

  也可直接在test.js文件顶部添加注释// @ts-check，强制启用类型检查和补全提示。

• 改用ES模块导入（可选）
  若项目支持ES模块，替换导入方式可提升类型识别效率：

  1. 在package.json中添加"type": "module"
  2. 修改test.js代码：

  import * as pdfjsLib from 'pdfjs-dist/build/pdf.js';
  
  const pdfPath = "test.pdf";
  const doc = await pdfjsLib.getDocument(pdfPath).promise;
  

内容的提问来源于stack exchange，提问作者me.at.coding