内容根是项目起点，需在settings→directories中添加多个内容根；src标为source仅解决索引，还需webpack路径配置、tsconfig.json的baseurl/paths及启用ts路径映射；排除文件夹应右键精确标记而非模糊模式；部署映射的deployment path须为相对服务器文档根的路径，多内容根需逐个配置映射。
WebStorm 项目路径配置不是“选一个文件夹就完事”，而是分层管理：内容根、源码标记、排除规则、部署映射，四者缺一不可。漏配任意一层，都会导致跳转失效、补全丢失或上传错位。
怎么设对内容根（Content Root）
内容根是 WebStorm 认为“属于这个项目的起点”。它不等于项目根目录，也不等于 package.json 所在位置——你可能需要多个内容根，比如把 UI 组件库和后端 API 模拟数据放在不同物理路径，但都纳入同一个项目上下文。
- 添加方式：打开
Settings → Directories（快捷键Ctrl+Alt+S），点击右侧的Add Content Root，选中目标文件夹 - 常见误操作：直接把整个硬盘盘符拖进去，或把
node_modules当作内容根——这会让索引爆炸、CPU 占用飙升 - 关键提示：内容根一旦添加，其子目录默认全是
Source类型；若某子目录实际是构建产物（如dist），必须手动右键 →Mark Directory as → Excluded
为什么 src 标成 Source 还是跳转不了
标为 Source 只解决“被索引”，不等于“能解析模块路径”。尤其遇到 @/utils 或 #components 这类别名时，WebStorm 需要两层支持：Webpack 配置识别 + TypeScript 路径映射。
- Webpack 层：进
Settings → Languages & Frameworks → JavaScript → Webpack，填入完整路径如config/webpack.config.js，填完务必点Reload configuration - TS 层：确保
tsconfig.json中有合法baseUrl（必须是"./src"，不能是"src"）和以/结尾的paths（如"@/*": ["*"]） - IDE 层：勾选
Use paths mapping from tsconfig.json，然后点击右下角 TypeScript 图标 →Restart TypeScript Service - 典型症状：
import { foo } from '@/api'运行正常但标红、Ctrl+Click 无响应——基本就是这三层没对齐
排除文件夹的两种写法，效果完全不同
在 Settings → Directories → Exclude files 里填模式，看着简单，但 lib 和 lib/ 的行为天差地别。
-
lib：匹配所有叫lib的文件夹，包括src/lib、node_modules/lib，甚至mylib（因为是子串匹配） -
lib/：只匹配名字**恰好是**lib的文件夹（注意末尾斜杠），不会误伤mylib，但也不会匹配src/lib——后者得写成src/lib - 更安全的做法：不在全局 Exclude 里写模糊模式，而是直接在项目工具窗口右键目标文件夹 →
Mark Directory as → Excluded，这样路径精确、可逆、不污染其他项目 - 特别注意：
dist、.next、.nuxt这类构建产物目录，必须排除，否则 WebStorm 会试图索引几万个小文件，卡死编辑器
部署路径映射为什么总传错地方
部署映射的 Deployment path 是相对服务器文档根的路径，不是绝对路径，也不是本地路径的镜像。很多人在这里填了 /var/www/html/myapp，结果上传到 /var/www/html/myapp/var/www/html/myapp。
- 确认服务器文档根：在
Deployment → Connection选项卡里看Folder字段，比如填的是/var/www/html -
Deployment path应该填相对路径，例如myapp，最终上传目标就是/var/www/html/myapp -
Web path填/myapp（带前导斜杠），这样浏览器访问http://localhost/myapp/index.html才能命中 - 调试技巧：上传后打开
Tools → Deployment → Browse Remote Host，对照左侧本地结构和右侧远程结构，一眼看出是否多套了一层
真正容易被忽略的，是内容根和部署映射的耦合关系：如果你加了多个内容根，但只在主内容根下配了部署映射，那其他内容根里的文件根本不会上传——WebStorm 不会自动把所有内容根都映射过去，得手动逐个配。
