PhpStorm 在 Ubuntu 中的文件搜索使用指南
一 常用搜索方式与快捷键
- 在当前文件中查找/替换：按 Ctrl + F（查找），Ctrl + R（替换）。
- 全局文本搜索（Find in Path）：按 Ctrl + Shift + F；全局替换：Ctrl + Shift + R。
- 按文件名打开文件：按 Ctrl + Shift + N（支持模糊匹配与大小写选项）。
- 查找类：按 Ctrl + N；查找符号（函数、变量、方法等）：按 Ctrl + Shift + Alt + N。
- 查找用法（调用位置、引用）：在符号上右键选择 Find Usages，或按 Alt + F7。
- 万能搜索入口：双击 Shift 打开 Search Everywhere，可同时搜索类、文件、动作、设置等。
二 搜索窗口的关键选项
- 匹配规则：点击搜索框旁的齿轮图标，启用 Match case（区分大小写）、Regex（正则）、Words（全词匹配）等，提高准确度。
- 搜索范围（Scope）：在窗口左下角选择 Scope，可限定为 Current File、Whole Project 或自定义目录/模块；经常用的范围可保存复用。
- 结果展示：勾选 Show results in “Find” window 可在面板集中查看与批量操作匹配项。
- 替换安全：勾选 Prompt to remove non-project files from replacement scope，避免误改外部文件；执行替换前先用 Find 逐步确认，再 Replace 或谨慎使用 Replace All。
三 让搜索更干净更快
- 忽略无关文件：在 Settings/Preferences → Appearance & Behavior → System Settings 勾选 Skip files and folders specified in .gitignore，并可在 File Types 中将 vendor、node_modules、.log 等标记为忽略，减少噪音。
- 自定义范围：在 Scope 中创建仅包含 .php 或特定目录的范围，后续搜索直接复用，命中更精准。
四 Ubuntu 常见故障排查
- 快捷键无响应（全局搜索打不开）：在 Ubuntu 中文输入法下，Ctrl + Shift + F 常被系统占用为简繁切换。解决方式：切换到 英文（或系统自带英文布局） 输入法后再尝试；或在 Settings → Keymap 为 “Find in Path/Replace in Path” 重新绑定快捷键。