PhpStorm 默认不标红硬编码字符串，因其多数场景合法必要；仅通过“String literal with no translation function”规则检查未被翻译函数包裹的UI文本。
为什么 PhpStorm 默认不标红硬编码字符串
PhpStorm 的 Inspections 里没有叫“硬编码字符串”的开箱即用规则——它不会主动把 'Hello World' 或 "user_id" 当作问题高亮。这不是漏配，而是设计使然：这类字符串在多数上下文中是合法且必要的（比如数组键、路由名、状态码）。真正需要拦截的，是那些**本该走翻译函数但被直接写死**的 UI 文本，例如 '删除用户' 出现在 HTML 模板或 Blade 中，却没包在 __('删除用户') 或 trans('delete_user') 里。
用「String literal with no translation function」规则精准捕获
PhpStorm 提供了更务实的检查项：String literal with no translation function（位于 PHP → Internationalization 下）。它只对满足两个条件的字符串触发警告：
- 字符串出现在 HTML/Blade/PHP 文件中，且上下文明显是用户可见文本（如
<p>{{ '欢迎登录' }}</p>、echo '操作成功';） - 该字符串未被包裹在已知的翻译函数内（如
__()、trans()、Lang::get()、__('key', $params)等）
启用方式：
- 进入
Settings/Preferences → Editor → Inspections → PHP → Internationalization - 勾选
String literal with no translation function - 点击右侧的
Configure...，在Translation functions列表里确认你项目实际使用的函数名已存在（默认含__、trans、lang等；若用__(...)，确保它在列表中） - 可调高严重级别为
Warning或Error，让编辑器立刻标黄/标红
绕过误报：给合法硬编码加注释豁免
有些字符串必须硬编码，比如数据库字段名、配置键、API 响应码，它们不是 UI 文本。若被误报，不要关规则，而是在字符串前加 PHPDoc 注释豁免：
立即学习“PHP免费学习笔记（深入）”；
// @no-intl $role = 'admin';
或者用内联注释：
$config['cache_ttl'] = /* @no-intl */ 3600;
注意：@no-intl 是 PhpStorm 内置的豁免标记，仅对本行生效，比全局禁用规则安全得多。
补充：自定义正则规则抓取遗漏模式
如果项目用了非标准翻译函数（如 i18n('key')），或想强制检查特定路径下的字符串（如所有 resources/views/**/*.blade.php 中的中文），可手动添加自定义 Inspection：
- 在
Inspections页面点击右上角+ → Add Custom Inspection - 选择
Regular expression类型 - Pattern 填：
'[\u4e00-\u9fa5]+[^']*'（匹配含中文的单引号字符串）或"[\u4e00-\u9fa5]+[^"]*"（双引号） - Scope 设为
Blade files或自定义文件模式 - 勾选
Case sensitive和Whole words only避免匹配变量名
这个规则无法识别是否已翻译，纯靠字符特征，适合兜底扫描，但需人工复核，避免误伤。
真正难的是区分“该翻译”和“不该翻译”——PhpStorm 不会读你心里想的业务语义，它只认函数包裹和上下文位置。所以别指望全自动，重点是把 Internationalization 规则配准、把豁免注释用熟、再用正则扫一遍高风险区域，就够了。
