GoLand通过检测pnpm-lock.yaml文件并结合系统已安装的pnpm自动切换包管理器；若未识别，需检查PATH环境变量及IDE启动方式。
GoLand怎么自动识别pnpm Monorepo项目
GoLand 会主动检测项目根目录下的 pnpm-lock.yaml 文件，只要它存在且你的系统已安装 pnpm，IDE 就会自动将当前项目包管理器切换为 pnpm。不需要手动设置，也不依赖 package.json 中的 packageManager 字段——那个字段只影响 CLI 行为，对 GoLand 的识别逻辑无作用。
常见错误现象：
- 明明有
pnpm-lock.yaml，但 GoLand 仍用 npm 运行脚本 - 终端里
pnpm -v能正常输出，但 GoLand 报错 “Command 'pnpm' not found”
原因基本就两个：
-
pnpm不在系统 PATH 环境变量中（尤其 macOS / Linux 用户常忽略 shell 配置文件如~/.zshrc是否重载） - GoLand 启动时未加载当前 shell 的环境（macOS GUI 应用默认不读取 shell 配置）
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在 GoLand 内置 Terminal 中执行
which pnpm，确认路径；若为空，先修复系统级安装 - macOS 用户：用
open -a "GoLand"从终端启动，确保继承 shell 环境 - Windows 用户：检查是否通过 Scoop/Chocolatey 安装，其 bin 目录是否已加入 PATH
如何让GoLand正确索引Monorepo中packages/*的子包
GoLand 默认只索引根目录和直接子目录下的 package.json，对 packages/* 这类 glob 匹配的 workspace 不会自动识别。你得显式告诉它哪些目录是“项目模块”。
关键动作不是改配置文件，而是用 IDE 的 UI 操作：
- 右键点击
packages/components目录 → Mark Directory as → Sources Root - 重复对
packages/core、packages/utils执行相同操作 - 确保每个子包的
package.json中有合法的name（如@myorg/components），且不含非法字符
不这么做会怎样？
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 跳转到
import { Button } from '@myorg/components'时失败 - TypeScript 类型提示不生效，即使
tsconfig.json已配好paths - 子包内定义的 ESLint 规则不会被单独应用
注意：pnpm-workspace.yaml 里的 packages: ['packages/*'] 对 GoLand 索引行为完全无效——它只管 pnpm CLI，不管 IDE。
运行dev脚本时为什么报“Cannot find module”
这是最典型的跨 workspace 引用失败表现，根本原因在于 GoLand 的 Node.js 运行配置没启用 --filter 或 --workspace 上下文，导致它直接在根目录执行 pnpm run dev，而根 package.json 并没有 dev 脚本，或脚本指向了不存在的路径。
正确做法是创建一个专用的 NPM 运行配置：
- 点击右上角 ▾ → Edit Configurations… → + → NPM
-
Package directory：选中具体子包目录，比如apps/web -
Command：填run dev（不是dev，也不是全路径） -
Working directory：自动填充为上一步选中的目录，别手改
切记不要用 “Run ‘pnpm run dev’ in root” 这种偷懒方式。pnpm 的 --filter 是 CLI 层能力，GoLand 的运行配置不解析它，也不会透传给子进程。
补充一点：如果子包 dev 脚本依赖其他 workspace 包（如 apps/web 依赖 packages/components），确保已在根 package.json 的 workspaces 字段声明对应路径，否则 pnpm link 阶段就会失败。
调试时断点不命中或变量显示为undefined
这通常不是 GoLand 的锅，而是 pnpm 的硬链接机制 + TypeScript 源码映射（source map）没对齐导致的。尤其当你在 packages/components 里修改代码，然后在 apps/web 中调试时，IDE 可能加载的是链接后的编译产物，而非原始 TS 文件。
必须检查三项：
- 子包的
tsconfig.json是否包含"sourceMap": true和"inlineSources": true - 构建脚本（如
tsc -b或vite build）是否生成了.map文件并放在正确位置（通常应与.js同目录） - GoLand 的 JavaScript Debug 配置中，“Remote URLs” 是否映射到了实际源码路径（例如
webpack://./src/Button.tsx→$PROJECT_DIR$/packages/components/src/Button.tsx）
最容易被忽略的一点：pnpm 的 .pnpm 目录是符号链接集合，某些调试器无法穿透多层链接定位原始文件。临时解法是把子包的 dist 目录加进 GoLand 的 Excluded 列表，强制它回退查找源码。
