Neovim Unreal Engine：P4 支持、宏向导和上下文感知文档！🚀（2025/12/04）

Source: Dev.to

UnrealDev.nvim

健康检查，安心无忧

新增 :checkhealth UnrealDev 用于验证你的 Unreal Engine 开发环境是否正确配置。
由于 nvim-treesitter 解析器并不总是会随插件管理器自动更新，可能会出现不同步的情况。运行此命令即可立即排查问题。

---

UNX.nvim (资源管理器)

终于… 支持 Perforce (P4)！

• 状态图标 – 在资源管理器中直接可视化 P4 状态（Add、Edit 等）。
• 自动检出 – 当你尝试修改只读文件时，会弹出对话框询问是否检出，消除 “文件为只读” 错误。

---

UCM.nvim (代码动作)

加速 Include 与宏

:UCM copy_include[!]

• :UCM copy_include – 复制当前文件的 include 路径。
• :UCM copy_include! – 打开模糊搜索提示，输入类名后复制对应的 include 路径。

# Example
:UCM copy_include

自动解析：在 MyActor.cpp 上运行后会生成 #include "Actor/MyActor.h" 并复制到剪贴板。

宏向导 (:UCM specifiers[!])

手动编写 UPROPERTY、UFUNCTION 或 UCLASS 宏既繁琐又容易出错。此向导为你自动完成。

普通模式 (:UCM specifiers)

1. 选择宏类型（例如 UPROPERTY）。
2. 多选修饰符（例如 EditAnywhere、BlueprintReadWrite）。
3. 在光标处插入完整宏 UPROPERTY(EditAnywhere, ...) 并复制到剪贴板。
4. 智能光标 – 若修饰符包含引号（如 Category=""），光标会在引号之间跳转，便于编辑。

追加模式 (:UCM specifiers!)

• 适用于编辑已有宏。
• 跳过宏包装，仅在光标位置插入修饰符（如 EditAnywhere）。

---

UEP.nvim (项目提供者)

更智能的导航与文档

文件与 Shader 增强

• Config/Shader 可见性 – 修复了 UEP tree 不显示 Config 或 Shaders 目录的问题。
• 虚拟路径 – 为 .ush / .usf 文件添加了虚拟 include 路径支持；open_files 现在可以直接跳转到这些文件。
• :UEP shaders[!] [Scope] – 快速搜索并打开 shader 文件。

C# 配置导航

• :UEP build_cs[!]

  • 不带 ! – 打开当前模块的 Build.cs。
  • 带 ! – 列出项目中所有 Build.cs 文件供选择。

• :UEP target_cs[!]

  • 不带 ! – 列出项目的 Target.cs 文件。
  • 带 ! – 在搜索中同时包含 Engine 目标。

上下文感知文档 (:UEP web_doc[!])

在浏览器中打开官方 Unreal Engine 文档，插件会自动检测项目使用的 UE 版本。

• 不带 ! – 搜索光标下的单词对应的文档。
• 带 ! – 让你从项目中选择一个类并打开其文档。

注意（实验性）：如果插件无法直接推断出 URL，会回退到站内搜索。

---

结论

本周的更新侧重于“生活质量”改进——解决那些让我怀念重量级 IDE 的小摩擦。现在我打开 Rider 的频率越来越低，Neovim 终于变得这么好用了！

如果你有功能需求或想法，请在评论或 issue 中告诉我。若你觉得这些插件有用，给 UnrealDev.nvim 点个 ⭐ 会让我非常开心！

祝编码愉快！ 💻✨