ctrl+shift+y没反应需先检查快捷键冲突：进入settings→keymap搜索translate，若显示“conflicts with...”则右键remove后重新assign；mac用户应使用cmd+shift+y而非ctrl键。

Translation 插件按 Ctrl+Shift+Y 没反应？先检查快捷键是否被覆盖

Translation 插件默认用 Ctrl+Shift+Y 翻译选中文本，但这个组合键在部分系统或插件下容易冲突。比如 Key Promoter X、IDEA Vim 或某些自定义宏可能劫持了它。

实操建议：

• 进 Settings → Keymap，搜索 Translate，确认绑定的是 Translation → Translate 动作
• 若显示“Conflicts with...”，右键该快捷键 → Remove 再重新 Assign
• 首次使用时插件会下载词典，稍有延迟，别急着连按——连续触发三次可能触发禁用保护
• Mac 用户注意：快捷键是 Cmd+Shift+Y，不是 Ctrl

翻译 PHPDoc 注释时乱码或漏译？别直接 Ctrl+Shift+Y 全选

PHPDoc 里常混着 @param、@return、代码片段（如 $array = []）和纯描述文本。Translation 插件对 Markdown/PHPDoc 结构无感知，全选后会把语法标记当普通文字翻，结果就是“参数数组”变成“参数阵列”，甚至把 int|null 翻成“整数或空值”这种不规范表述。

正确做法：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 只选中自然语言段落（比如 /** 从数据库获取用户列表 */ 中的中文部分）
• 遇到 @see 或 @link 行，跳过不选——这些是引用，不是说明
• 函数签名行（如 function getUser(int $id): ?User）绝对不要选，否则会破坏类型提示
• 想批量处理整个文件注释？用 Ctrl+Shift+O 打开翻译面板，粘贴纯文本再译，可控性更高

为什么翻译 Laravel 的 Facade 方法名总出错？得关掉“自动检测语言”

Laravel 文档里大量使用 Auth::user()、Cache::get() 这类写法。Translation 插件开启“自动检测语言”后，会把 Auth 当作英文单词（auth 是“授权”），把 Cache 当作名词（缓存），结果译成“授权::用户()”“缓存::获取()”，语义完全跑偏。

解决方式很直接：

• 打开 Settings → Other Settings → Translation
• 取消勾选 Auto-detect language
• 手动将源语言设为 English，目标语言设为 Chinese (Simplified)
• 对这类框架专用词，建议在 Custom Dictionary 里加白名单：Auth → 认证门面、Cache → 缓存门面，避免反复误译

翻译后替换代码里的英文变量名？小心破坏 PSR-2 和类型推导

有人习惯用 Translate and Replace 把 $response 直接替换成 $响应。这看似省事，但 PhpStorm 的类型系统依赖 ASCII 变量名做符号解析，非 ASCII 名称会导致：

• phpstan / psalm 静态分析报错 Invalid character in variable name
• Laravel IDE Helper 生成的 stub 文件无法识别该变量
• Git diff 显示乱码，协作时别人根本看不懂你改了啥
• 某些 PHP 扩展（如 opcache）在严格模式下拒绝加载含 Unicode 变量名的文件

真正安全的做法是：只翻译注释、文档字符串、日志文案；变量名、方法名、类名坚持用英文——这是行业事实标准，不是个人偏好问题。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！