# 在文件中查找替换文本
标准工具帮助您在活动编辑器中查找和替换文本字符串。
在这个页面中:
* [搜索当前文件](#搜索当前文件)
* [在当前文件中替换](#在当前文件中替换)
* [使用搜索结果](#使用搜索结果)
* [搜索和替换选项](#搜索和替换选项)
## 搜索当前文件
1. 从主菜单中,选择**Edit | Find | Find**,或按`Ctrl+F`。搜索面板显示在活动编辑器的顶部。
2. 如果需要,指定[搜索选项](#搜索和替换选项)
3. 在搜索字段中,开始输入搜索字符串:
![搜索当前文件](http://image.jellychen.cn/uploads/2017/01/wi_findText.png)
在输入时,当前光标位置后第一次出现的搜索字符串被选中;其他找到的在编辑器中突出显示。此外,找到的匹配项在右槽中用条纹标记。
4. [浏览搜索结果](#使用搜索结果)
## 在当前文件中替换
1. 从主菜单中,选择**Edit | Find | Replace**,或按`Ctrl+R`。搜索和替换面板显示在活动编辑器的顶部。
2. 如果需要,指定[搜索和替换选项](#搜索和替换选项)。
3. 在搜索字段中,开始输入搜索字符串。当你输入时,匹配的字符串在编辑器中高亮显示,并且**Replace**弹出对话框在第一个匹配项出现时打开,建议你用空字符串替换当前字符串,或所有匹配项,
4. 开时输入匹配字符串。
5. [浏览搜索结果](#使用搜索结果),并且使用替换对话框的按钮,根据需要替换匹配项。参见下方的[搜索和替换选项](#搜索和替换选项)。
## 使用搜索结果
* 要启动新搜索,请执行以下操作之一(基于于当前焦点):
* 如果编辑器有焦点,请按`Ctrl+F`
* 如果搜索字段具有焦点,请按`Ctrl+A`
在这两种情况下,现有的搜索字符串将被选中,您可以开始输入新的搜索字符串。
* 要在匹配项之间跳转,请执行以下操作之一:
* 按`Shift+F3`(跳到上一个选择)或`F3`(跳到下一个选择)。
* 在**Search**面板中使用![向上箭头](http://image.jellychen.cn/uploads/2016/11/arrowUp.png)或![向下箭头](http://image.jellychen.cn/uploads/2016/11/arrowDown.png)按钮。
* 单击右槽条纹。
* 搜索面板显示找到的匹配数。如果未找到匹配项,则搜索面板将高亮显示为红色:
![未找到匹配项](http://image.jellychen.cn/uploads/2017/01/wi_findTextNull.png)
* 在**Find**和**Replace**面板中使用代码完成。开始输入搜索字符串,按`Ctrl+空格`,然后从建议列表中选择相应的词语。
* 使用近期搜索记录:在搜索面板已打开的情况下,单击![查找按钮](http://image.jellychen.cn/uploads/2017/01/find1.png)以显示最近的输入列表。
* 在**Find**和**Replace**面板已打开的情况下,使用`Ctrl+R`或`Ctrl+F`在面板之间切换。这样,会保留搜索和替换的字符串。
* 要取消操作并关闭面板,按`Esc`。
* 使用**多重选择**(**多选**)。例如,如果某个字符串已被高亮显示为搜索结果,则可以通过单击![添加](http://image.jellychen.cn/uploads/2017/01/add_selection_icon.png)(`Alt+J`)将此字符串的匹配项添加到多个选择中,使用![移除](http://image.jellychen.cn/uploads/2017/01/remove_selection_icon.png)(`Shift+Alt+J`)从多个选择中删除匹配项,或使用![全选](http://image.jellychen.cn/uploads/2017/01/select_all_occurrences_icon.png)(`Ctrl+Shift+Alt+J`)将所有找到的匹配项添加到多个选择。
## 搜索和替换选项
|项目|描述|Search/Replace|
|---|---|---|
|![查找按钮](http://image.jellychen.cn/uploads/2017/01/find1.png)|单击此按钮显示最近输入的历史记录。|Search, replace|
|![清空](http://image.jellychen.cn/uploads/2017/01/closeBlack.png)|单击此按钮以清除搜索字段。|Search, replace|
|![向上箭头](http://image.jellychen.cn/uploads/2016/11/arrowUp.png) ![向下箭头](http://image.jellychen.cn/uploads/2016/11/arrowDown.png)|单击这些按钮可以跳转到搜索字符串的匹配项。|Search, replace|
|![添加](http://image.jellychen.cn/uploads/2017/01/add_selection_icon.png)|单击此按钮将下一个找到的匹配项添加到多重选择。|Search|
|![移除](http://image.jellychen.cn/uploads/2017/01/remove_selection_icon.png)|单击此按钮可从多重选择中删除找到的匹配项。|Search|
|![全选](http://image.jellychen.cn/uploads/2017/01/select_all_occurrences_icon.png)|单击此按钮可创建一个包含所有找到的匹配项的选择。|Search|
|![导出按钮](http://image.jellychen.cn/uploads/2016/12/exportToTextFile.png)|单击此按钮可在[查找工具窗](/参考/工具窗参考/查找工具窗.md)中显示搜索结果。|Search, replace|
|Match Case|如果选中此复选框,PhpStorm将在搜索时区分大写和小写字母。|Search, replace|
|Regex|如果选中此复选框,则搜索字符串将被视为[正则表达式](/参考/正则表达式语法参考.md),替换预览显示在工具提示中(请参阅[示例](/如何使用/常规指南/搜索代码/在文件中查找替换文本.md)章节)。|Search, replace|
|Words|如果选中此复选框,PhpStorm将仅搜索整个单词,即,用空格,制表符,标点符号或特殊字符分隔的字符串。 如果选中了**Regular expressions**复选框,则此复选框被禁用。|Search, replace|
|Preserve Case|如果选中此复选框,PhpStorm将保留第一个字母的大小写和一般的初始字符串大小写。例如,如果您将 _yourtest_ 指定为替换项, _MyTest_ 将替换为 _Yourtest_ 。 如果选中了**Regular expressions**复选框,则此复选框被禁用。|Replace|
|In Selection|如果选中此复选框,搜索和替换将仅限于所选文本。|Replace|
|Replace|单击此按钮替换当前匹配到的内容,然后跳到下一个匹配项。|Replace|
|Replace all|单击此按钮,替换当前文件中或选择区域中发现的所有匹配项。|Replace|
|Exclude/Include|单击**Exclude**按钮跳过当前匹配项,并将其从**Replace all**操作中排除。此匹配的按钮更改为**Include**。|Replace|
|![设置](http://image.jellychen.cn/uploads/2017/01/cogwheel_blue.png)|单击此按钮可调用扩展选项列表。勾选相应的选项将搜索限制在指定的范围,而忽略其他地方的匹配项。|Search, replace|
# 另请参阅:
入门指南:
* [PhpStorm编辑器](/如何使用/常规指南/PhpStorm编辑器/README.md)
* [多插入符](/如何使用/常规指南/PhpStorm编辑器/基础编辑规程/多插入符.md)
参考:
* [正则表达式语法参考](/参考/正则表达式语法参考.md)
教程和例子:
* [使用正则表达式查找和替换文件中的文本](/教程/使用正则表达式查找和替换文件中的文本.md)