VSCode自动导入依赖语言服务准确解析模块路径，需确保tsconfig.json/jsconfig.json置于工作区根目录、baseUrl设为"."、paths严格匹配别名使用方式，并重启TS服务器；同时启用typescript.suggest.autoImports等设置，禁用冲突插件，优先使用Ctrl+.手动触发。
VSCode 的自动导入（Auto Import）不是“开个开关就灵”，它依赖语言服务对模块路径的准确解析；如果 import 标红、Ctrl+点击跳转失败、补全不出现 @/ 路径，说明路径映射没被语言服务真正识别——不是代码写错了，是编辑器没“看懂”你的项目结构。
tsconfig.json 或 jsconfig.json 没生效或配错
VSCode 的 TypeScript/JavaScript 语言服务只认 tsconfig.json（TS 项目）或 jsconfig.json（JS 项目），且必须放在你通过 File → Open Folder 打开的工作区根目录下。两个文件同时存在时，tsconfig.json 会完全屏蔽 jsconfig.json。
- 确认项目里有没有
.ts文件或typescript依赖：有则必须用tsconfig.json，否则用jsconfig.json -
compilerOptions.baseUrl必须设为"."（相对配置文件自身），不能是"./src"再配"@/*": ["src/*"]—— 这种写法会让路径解析错位 -
paths映射要严格匹配别名使用方式，例如用了import x from '@/utils/api'，就必须配"@/*": ["src/*"]，而不是"@/*": ["./src/*"]或"@/*": ["src/**"] - 改完配置后，必须执行命令面板里的
Developer: Restart TS Server，仅重开文件或窗口无效
VSCode 正在用内置 TypeScript 而非工作区版本
如果你项目里装了 typescript@5.6.3，但 VSCode 默认调用的是自带的 4.9 版本，paths 解析行为可能不一致，导致别名识别失败。
- 按
Ctrl+Shift+P（Mac 是Cmd+Shift+P），输入TypeScript: Select TypeScript Version - 选择
Use Workspace Version，确保右下角状态栏显示的版本号和node_modules/typescript/package.json里一致 - 如果状态栏显示
JavaScript (Deprecated)，说明 JS 语言服务异常，可尝试删掉node_modules/typescript后重装
Python 项目里 import 报错但运行正常
这是 Python 解释器启动路径和 VSCode 终端工作目录不一致导致的典型问题：直接跑 python src/main.py 时，sys.path[0] 是 src/ 目录；而 VSCode 默认以工作区根目录为 cwd，src/utils.py 就不在搜索路径里。
- 最轻量解法：启用
python.terminal.executeInFileDir，让右键「Run Python File in Terminal」时自动cd到当前文件所在目录 - 长期规范解法：用
python -m模式，例如在launch.json里配"module": "src.main"，并确保项目根目录含__init__.py - 避免在业务代码里硬写
sys.path.append('..')—— 这会让 CI/CD 和协作环境失效
Pylance 或 TypeScript 插件冲突
第三方补全插件（比如 Auto Import by wix、ES7+ React snippets）会劫持 Ctrl+Space 行为，覆盖语言服务原生的自动导入逻辑，导致符号识别混乱、补全项缺失或跳转错乱。
- 临时禁用所有非必要插件，只留 Pylance（Python）或官方 TypeScript 插件（TS/JS），验证是否恢复
- 确保
typescript.suggest.autoImports和javascript.suggest.autoImports设为true（布尔值，不是字符串） - 手动触发导入更可靠：光标停在未定义符号上，按
Ctrl+.（Windows/Linux）或Cmd+.（Mac）调出「Quick Fix」，选 “Import …”
真正卡住人的往往不是配置本身，而是改完没重启语言服务、用了工作区外的 TS 版本、或者插件悄悄接管了补全入口——这些点不逐个验证，光调 settings.json 永远是隔靴搔痒。
