Linux下VS Code中MGCB Content Builder无法正常启动求助

问题现象 #

• 已安装MGCB VS Code扩展，但右键点击Content.mgcb文件时无运行/打开选项
• 终端执行dotnet mgcb-editor后，编辑器界面仅显示空白框架，缺失导入文件、添加内容等核心操作按钮（与教程中具备完整功能的界面不符）

解决步骤 #

1. 补全MGCB工具链安装 #

Linux下MonoGame的内容构建工具需要完整的命令行工具和运行依赖，执行以下命令：

# 安装MGCB命令行工具
dotnet tool install -g dotnet-mgcb
# 安装MGCB编辑器
dotnet tool install -g dotnet-mgcb-editor
# 注册编辑器到系统，关联文件类型
mgcb-editor --register

--register步骤是关键，它会配置系统层面的文件关联，让VS Code扩展能正确识别.mgcb文件。

2. 修复VS Code的文件关联配置 #

• 打开VS Code设置（快捷键Ctrl+,）
• 搜索files.associations，添加如下配置：

  "files.associations": {
      "*.mgcb": "mgcb"
  }
  

• 重启VS Code后，右键Content.mgcb文件即可看到Open with MGCB Editor选项。

3. 检查环境变量与权限 #

• 确认~/.dotnet/tools目录在系统PATH中：执行echo $PATH查看，若未包含，将以下内容添加到~/.bashrc或~/.zshrc：

  export PATH="$PATH:$HOME/.dotnet/tools"
  

  执行source ~/.bashrc（对应你的shell配置文件）使修改生效。
• 确保当前用户对~/.dotnet/tools目录有读写权限，避免工具无法正常调用。

4. 验证项目的MGCB引用 #

打开项目的.csproj文件，确认包含以下配置项：

<ItemGroup>
  <MonoGameContentReference Include="Content\Content.mgcb" />
</ItemGroup>

若缺失，手动添加后重新加载项目。

5. 重置编辑器缓存 #

如果以上步骤无效，删除编辑器缓存后重试：

rm -rf ~/.local/share/MonoGame/MGCB Editor

重新运行mgcb-editor即可加载干净的编辑器环境。

内容的提问来源于stack exchange，提问作者Scollier