static等目录必须设为Resources Root而非Sources Root，否则路径补全失效且索引混乱；右键目录→Mark Directory as→Resources Root即可生效。
必须手动标记，PhpStorm 不会自动识别 static、public 或 assets 这类目录为资源根目录；不标，url_for('static')、@import、require('./assets/logo.png') 都会红波浪线报错，路径补全失效。
为什么 static 目录不标成 Sources Root？
标成 Sources Root 会让 PhpStorm 把 CSS/JS/图片当 PHP 源码索引：跳转到函数名时误入 HTML 里的 onclick，Find Usages 扫出一堆无意义的字符串匹配，内存占用翻倍。它只该放源码（.php、.js 逻辑文件），不是静态资源。
-
static、public、assets、resources这类目录应统一设为Resources Root -
Resources Root的作用是让 IDE 理解“相对路径从这里算起”，比如./css/app.css就指该目录下的css/app.css - 它不参与符号索引，不影响性能，但能修复路径补全、
url_for提示、Webpackpublic引用解析
怎么正确标记 Resources Root？
右键目标文件夹 → Mark Directory as → Resources Root。这是唯一可靠方式，设置里找不到“全局默认”开关。
- 常见位置：
public（Laravel、Symfony）、static（Flask、Django）、src/assets（Vue/React） - 如果项目有多个资源目录（如
public+src/images），每个都要单独右键标记 - 标记后，IDE 会在目录图标上显示小地球图标，表示已生效
- 标错了？右键 →
Unmark as Resources Root即可撤回，无副作用
标完还是报错？检查这三点
标记只是第一步，路径解析还依赖上下文环境。以下情况会导致标记“看似无效”：
立即学习“PHP免费学习笔记（深入）”；
- 当前文件不是在支持资源路径解析的类型里：比如你在纯
.txt文件里写./img/logo.svg，不会触发补全——确保在.html、.vue、.js或模板引擎（Twig、Blade）文件中使用 - 前端构建工具（Webpack/Vite）用了别名（如
@/assets），但 PhpStorm 没配Path Mappings：进Settings → Languages & Frameworks → JavaScript → Libraries → Path Mappings，加一条Prefix: @/→Directory: src/ - PHP 框架路由或模板函数（如 Laravel 的
asset()、Flask 的url_for('static')）未被识别：给入口文件（如public/index.php或app.py）加@var注释，或在Settings → PHP → Include Paths中添加对应框架的 vendor 路径
最常被忽略的是：Resources Root 只解决“路径怎么算”，不解决“这个路径运行时是否存在”。调试时 404，得查 Web 服务器配置和实际文件位置，和 PhpStorm 标记无关。
