TypeScript自动导包不生效的常见原因有二：项目未被正确识别为TS项目，或TS服务未加载成功；需检查tsconfig.json位置、配置jsconfig.json、重启TS服务器、调整VSCode设置并禁用冲突插件。
TypeScript自动导包不生效的常见原因
VSCode默认支持TypeScript自动导包，但多数人开箱即用失败，核心就两点：项目没正确识别为TS项目，或TS服务没加载成功。
检查 tsconfig.json 是否存在且位于工作区根目录；如果项目是JS项目但启用了checkJs，需确保 jsconfig.json 里有 "checkJs": true 和 "allowSyntheticDefaultImports": true 等基础配置。
- 打开命令面板（Ctrl+Shift+P），运行
Developer: Toggle Developer Tools，看Console里有没有Failed to load typescript类错误 - 右下角状态栏若显示
JavaScript (Deprecated)，说明VSCode正在用旧版JS语言服务，要删掉node_modules/typescript并重装最新版typescript - 多根工作区中，只有「活动文件夹」下的
tsconfig.json被识别，其他子文件夹需单独配tsconfig.json或用extends继承
开启自动导入（Auto Import）的关键设置
不是所有自动导入都靠插件——TypeScript语言服务原生支持，但默认只在你输入时触发，不会主动补全未声明的符号。要让它“看到就导”，得调几个关键开关。
- 确保
"typescript.preferences.autoImportFileCandidates": "enabled"（VSCode 1.86+ 默认开启） - 关闭
"javascript.suggest.autoImports"和"typescript.suggest.autoImports"的值设为true（注意不是字符串"true"） - 禁用第三方补全插件如
Auto Import（wix的）或ES7+ React/Redux/React-Native snippets，它们会劫持Ctrl+Space行为，和TS服务冲突 - 输入符号后按
Ctrl+.（Windows/Linux）或Cmd+.（macOS）手动触发「快速修复」，这是最稳定、最可控的导入方式
路径别名（@/、~/）提示失效怎么办
TS能识别路径别名，但VSCode不一定能——它依赖 tsconfig.json 中的 compilerOptions.baseUrl 和 paths，且必须重启TS服务器才能生效。
-
baseUrl必须是相对tsconfig.json的路径，比如"baseUrl": "./src"，不能写成"./"后再配"@/*": ["src/*"] - 修改
tsconfig.json后，必须执行Restart TS Server（命令面板搜这个）；仅重开文件或窗口无效 - 如果用 Vite 或 Webpack，它们的别名配置（如
resolve.alias）对VSCode无影响，VSCode只认tsconfig.json - 路径提示不出现？检查当前文件是否在
include列表里，比如"include": ["src/**/*"]漏掉了tests/目录
为什么有时自动导入导出的是 namespace 而不是模块
这通常是因为你引用了声明文件（.d.ts）里用 declare namespace 定义的内容，TS会把它当作全局命名空间处理，而非可导入模块。
- 遇到
import * as foo from 'foo'自动补全但无法解析，先查node_modules/foo/index.d.ts是否含declare namespace foo - 想强制走模块导入？加一个空的
export {}在声明文件末尾，把命名空间“升级”为模块上下文 - 某些库（如
lodash）默认导出是 namespace，要用import _ from 'lodash'而非import * as _ from 'lodash'，否则类型可能丢失 - VSCode不会帮你判断哪种导入更合适，它只按TS语言服务返回的结果展示——所以最终行为取决于
node_modules里实际的类型定义结构
路径别名和自动导入看似简单，实际卡点都在配置与TS服务状态的同步上。改完 tsconfig.json 不重启服务，或在错误的工作区层级开文件，都会让功能静默失效。
