macos 下不建议直接软链接 node_modules，因其会破坏模块解析、引发 esm/cjs 报错、热更新失效及 typescript 路径映射失准；应改用 pnpm workspace 或 pnpm link + dist 引用。
macos 下不建议直接对整个 node_modules 做软链接（ln -s）来“优化”，因为这会破坏模块解析逻辑、引发 esm/cjs 混用报错、导致热更新失效，甚至让 require.resolve 和 typescript 路径映射失准。真正的优化方向是：**避免重复生成 node_modules，而不是手动链接它**。
为什么不能直接 ln -s node_modules？
• node_modules 是 npm/pnpm/yarn 运行时动态构建的依赖图结构，包含符号链接、硬链接、.bin 入口、peer 依赖校验等机制
• 手动软链一个项目的 node_modules 到另一个项目，会导致：
– 解析路径错乱（如 require('lodash') 可能命中错误版本）
– package.json 中 exports 或 types 字段失效
– Vite/Webpack 的 HMR 无法追踪源文件变更
– TypeScript paths 映射和 baseUrl 失效
正确做法：用 pnpm + workspace 或 link + dist 引用
✅ 推荐方案一：pnpm workspace（适合多包单仓）
在根目录 pnpm-workspace.yaml 中声明：
- "packages/*"
- "apps/*"
然后各子包通过 pnpm add my-utils --filter app-frontend 安装本地依赖，pnpm 自动建立硬链接+符号链接组合，node_modules 不重复，且 import 可靠。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
✅ 推荐方案二：pnpm link + 构建后引用（适合跨仓库调试）
1. 在工具库项目中执行：
pnpm build（确保输出 dist/index.cjs 和 dist/index.d.ts）
2. 在前端项目中运行：
pnpm add ../my-utils
→ pnpm 会把 ../my-utils 软链进 node_modules/my-utils，并自动解析 main/types 字段
3. 不需 pnpm link 手动两步操作，更稳定
补充：如果真要临时软链（仅限极简脚本场景）
仅限非工程化、无构建流程的纯 Node 脚本，且明确知道风险：
- 确保目标
node_modules已完整安装（pnpm install成功） - 在新项目根目录执行：
rm -rf node_modules && ln -s ../shared-project/node_modules - 必须同步
pnpm-lock.yaml和package.json，否则下次pnpm install会覆盖软链 - 禁用所有构建工具的缓存（Vite 清
node_modules/.vite，TS 清./tsbuildinfo）
这种做法不可持续，仅作临时验证，上线前务必回归标准流程。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
