VSCode无法F12跳转到本地linked的shared-utils函数，根本原因是TS语言服务未正确识别源码路径；需配置tsconfig.json的baseUrl/paths、将shared-utils加入.code-workspace folders、确保其生成.d.ts声明文件，并重启TS服务。
VSCode 本身不提供“项目全局函数库”的自动索引或跨项目跳转能力，所谓“管理通用函数库”，本质是让编辑器能正确识别、跳转、补全和类型检查——这取决于你如何组织代码、配置路径映射、启用语言服务，以及插件是否在正确的上下文中激活。
为什么 F12 跳不到本地 shared-utils 里的函数
常见现象：shared-utils 是独立 npm 包，已用 yarn link 或 npm link 软链进当前项目的 node_modules，但按 F12 仍提示 “No definition found”。
- TypeScript 语言服务默认只从
node_modules中加载已发布包的声明（.d.ts），而本地 linked 包若没生成或导出类型，TS 就无法解析 -
jsconfig.json或tsconfig.json里没配"baseUrl"和"paths"，导致 import 路径（如@utils/xxx）无法被映射到真实文件 - VSCode 没在工作区根目录下读到有效的
tsconfig.json，或该配置被.code-workspace中的设置意外覆盖 - 插件（如 TypeScript Hero、Auto Import）未在当前文件夹启用——多根工作区中，扩展默认只对“活动文件夹”生效
怎么让 import "@utils/*" 正确跳转和补全
关键不是装某个插件，而是确保 TS 语言服务能“看见”源码。推荐走标准路径映射 + 工作区显式包含：
- 在项目根目录的
tsconfig.json中添加：{ "compilerOptions": { "baseUrl": ".", "paths": { "@utils/*": ["../shared-utils/src/*"] } } } - 把
shared-utils文件夹直接加入 .code-workspace 的folders数组，确保它在资源管理器中可见 - 确认
shared-utils/tsconfig.json有"declaration": true且构建后生成了dist/index.d.ts，或直接在源码里写export+declare module - 重启 TS 服务：按
Ctrl+Shift+P→ 输入TypeScript: Restart TS server
哪些插件真有用，哪些只是干扰
插件不是越多越好；多数“函数库管理”类插件（如 Import Cost、Path Intellisense）只解决边缘问题，核心依赖仍是 TS 配置和工作区结构。
-
Auto Import：有用，但必须设为 “This Folder” 启用，否则在 frontend/ 里会尝试从 backend/ 的 node_modules 补全 -
TypeScript Toolbox：可关掉，它的自动导入逻辑常和 TS 官方行为冲突，尤其在 paths 映射场景下 -
Project Manager：不解决跳转问题，只帮你快速切换预存的工作区，适合多客户项目，但对函数库无感 -
ES7+ React/Redux/React-Native snippets：纯模板，和函数库无关，别指望它帮你 resolve@utils
容易被忽略的配置细节
最常卡住人的不是语法或命令，而是路径精度和作用域错位：
-
paths映射中的相对路径（如"../shared-utils/src/*"）必须相对于tsconfig.json所在位置，不是相对于当前文件或工作区根 - 如果用了
.code-workspace，且shared-utils在上层目录（如../shared-utils），则tsconfig.json里不能写"baseUrl": ".."—— TS 不支持向上越级解析 baseUrl -
jsconfig.json和tsconfig.json不能共存于同一文件夹，否则 VSCode 可能随机选一个，导致类型丢失 - VSCode 的 “Go to Definition” 默认只查当前工作区已加载的文件；如果
shared-utils没出现在 .code-workspace 的folders里，就算路径对，F12 也进不去
