AgentSkillsCN

ue-dev-env-config

配置 Unreal Engine 开发环境的 VSCode 设置，包括 IntelliSense、编译任务、调试配置和扩展推荐。当需要在 VSCode 中开发 UE C++ 插件或项目时使用此技能。自动检测 UE 引擎和 Visual Studio，支持插件和项目工作区。

SKILL.md
--- frontmatter
name: ue-dev-env-config
description: 配置 Unreal Engine 开发环境的 VSCode 设置，包括 IntelliSense、编译任务、调试配置和扩展推荐。当需要在 VSCode 中开发 UE C++ 插件或项目时使用此 skill。自动检测 UE 引擎和 Visual Studio，支持插件和项目工作区。
allowed-tools: Bash, Read, Write, Glob

UE 开发环境配置

配置 Unreal Engine 开发环境的 VSCode 工作区设置。

前置条件

  • •Python 3.7+：脚本使用标准库，无需安装额外依赖
  • •Windows 系统：脚本针对 Windows 平台的 UE 开发环境设计
  • •Visual Studio：需要安装 MSVC 编译器（UE 开发必需）
  • •Unreal Engine：已安装的 UE 引擎（脚本会自动检测）

快速开始

在工作区根目录运行：

bash
python scripts/setup_vscode_env.py

注意：在 Bash shell 中，路径中的反斜杠需要用引号包裹，或者使用正斜杠（跨平台兼容）。

bash
# 推荐：使用正斜杠（所有 shell 都支持）
python scripts/setup_vscode_env.py

# Bash/CMD：路径含空格时用引号
python "scripts/setup_vscode_env.py"

# 避免：Bash 中不用引号的反斜杠路径
# python scripts\setup_vscode_env.py  # 可能出错

脚本会自动：

  1. •检测工作区类型（插件/项目）
  2. •搜索 UE 引擎安装
  3. •检测 Visual Studio 和 MSVC
  4. •生成所有 VSCode 配置文件

使用选项

bash
# 指定引擎路径
python scripts/setup_vscode_env.py -e "F:/Epic Games/UE_5.4"

# 指定项目路径（用于调试）
python scripts/setup_vscode_env.py -p "F:/Unreal Projects/MyProject.uproject"

# 非交互模式（自动选择第一项）
python scripts/setup_vscode_env.py --non-interactive

# 强制指定工作区类型
python scripts/setup_vscode_env.py --is-plugin
python scripts/setup_vscode_env.py --is-project

生成的配置文件

文件用途
c_cpp_properties.jsonIntelliSense 配置（include 路径、宏定义）
tasks.json编译任务（Build Plugin、编译项目）
launch.json调试配置（启动/附加 UE 编辑器）
settings.json编辑器设置（Tab 大小、文件关联）
extensions.json推荐扩展（C++ 工具、GitLens 等）

详细说明

配置完成后

  1. •重新加载 VSCode 窗口（F1 → "Reload Window"）
  2. •安装推荐的扩展
  3. •等待 IntelliSense 索引完成

OpenCode LSP 配置

如需使用 OpenCode 的 clangd LSP：

bash
# 安装 clangd
python scripts/setup_opencode_lsp.py

# 生成 opencode.json
python scripts/configure_opencode_json.py