<p>jsconfig.json中typeAcquisition失效需改用显式安装@types包或JSDoc注释：npm install @types/d3，或在代码前加/* @type {import('d3').Selection} /，并确保jsconfig.json含"checkJs": true和"allowJs": true。</p>
jsconfig.json 配置 typeAcquisition 失效怎么办
直接在项目根目录新建 jsconfig.json 并写入 typeAcquisition，对很多库（比如 d3、lodash）已不再可靠。VS Code 从 1.60 版本起逐步弱化该机制，尤其在没有 @types 包支持时几乎不生效。
真正起作用的是类型定义文件本身，而不是配置项自动拉取。所以别再指望 "include": ["d3"] 自动给你补全 —— 它只对极少数内置支持的库（如 jquery）还有残留效果。
- 检查 VS Code 版本：运行
Help > About，确认不是 1.70+；老版本可能还凑合，新版本基本失效 - 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，看 Console 是否报Failed to load types for d3类错误 - 临时验证方式：在 JS 文件顶部加一行
// @ts-check，再写d3.，如果没提示，说明类型没加载成功
npm install @types/xxx 是最稳的引入方式
当前（2026 年）标准做法是显式安装类型包，而不是依赖自动发现。VS Code 的 JavaScript 语言服务会主动读取 node_modules/@types 下的声明文件，并为同名库提供补全。
例如引入 axios 提示：
npm install --save-dev @types/axios
装完后无需重启 VS Code，几秒内就能在 import axios from 'axios' 后输入 axios. 看到方法列表。注意以下几点：
-
@types包名必须和实际库名完全一致（@types/react-router-dom≠@types/react-router） - 某些库自带
.d.ts（如zod、valtio），装本体即可，不用额外装@types - 若库名含横线，
@types中用下划线替代（@types/express-session→@types/express_session）
没 @types 的库怎么加提示
像一些小众工具库（如 chart.js 旧版、wps-js-sdk）长期没维护 @types，或者类型定义严重滞后，这时得手动干预。
推荐优先尝试 JSDoc 注释 + jsconfig.json 组合：
- 在使用位置上方加
/** @type {import('xxx').SomeClass} */，例如：/** @type {import('chart.js').Chart} */ const myChart = new Chart(...); - 确保
jsconfig.json开启"checkJs": true和"allowJs": true - 如果库提供 UMD 全局变量（如通过 CDN 引入的
moment），可在jsconfig.json的"compilerOptions.types"中显式列出："types": ["node", "moment"]
注意：import() 写法依赖库本身导出类型，若库没导出，JSDoc 也无效 —— 这时候只能靠手写 .d.ts 声明文件，放在 src/types/xxx.d.ts 下，内容类似：declare module 'xxx' { export function doSomething(): void; }
Path IntelliSense 和 Node.js Modules IntelliSense 不解决第三方库提示
这两个插件名字容易误导人。Path IntelliSense 只补全路径字符串（比如 import './utils/ 后自动列出文件），Node.js Modules IntelliSense 仅对 Node.js 原生模块（fs、path）或已安装的 npm 包名（require('ax → 补全 axios）有效，但不提供 API 方法级提示。
也就是说，它能帮你快速写出 import _ from 'lodash'，但写 _.debounce( 时依然没参数提示 —— 这部分必须靠 @types/lodash 或 JSDoc。
常见误判场景：
- 装了
Node.js Modules IntelliSense就以为axios.get有提示 → 实际没有 - 看到路径补全正常，就认为整个库都已“接入” → 补全路径 ≠ 补全 API
- 在 HTML 中通过
<script src="https://cdn.xxx.com">引入，期望插件自动识别 → 不支持 CDN 场景
真正的第三方库代码提示，核心永远是类型定义的存在与可被解析，不是路径或模块名补全。
