VSCode + Unity 游戏开发环境一键启动流程

741 阅读1分钟

VSCode + Unity 游戏开发环境一键启动流程

核心思想:借助一个 zsh 脚本,把双击 Unity 脚本时的打开操作,定向到你自己管理的 .code-workspace(既包含前端/后端工程,也包含 Unity 项目),并且自动跳到对应文件和行号。

image.png


一、准备一个多根工作区文件

在你本地随意目录下创建工作区文件,比如 ~/projects/projectX.code-workspace,内容示例:

{
  "folders": [
    {
      "name": "UnityGame",
      "path": "/Users/who/projects/unity-game"
    },
    {
      "name": "WebServer",
      "path": "/Users/who/projects/projectX-server"
    }
  ],
  "settings": {
    "files.exclude": {
      "**/*.meta": true,
      "**/Library": true
    },
    // ……你在 VSCode 里对前后端、C#、zsh 脚本的个性化设置
  },
  "extensions": {
    "recommendations": [
      "ms-dotnettools.csharp",
      "unity.unity-debug",
      "esbenp.prettier-vscode"
    ]
  }
}

目的

  • 一次打开,就能同时看到 Unity C#、Node/Go 后端、前端代码;
  • 可以统一设置格式化、排除规则、插件推荐。

二、写一个 zsh 脚本来接管 “打开脚本” 的逻辑

新建脚本 ~/bin/unity-open-vscode.sh,把它当成 Unity 外部脚本编辑器:

#!/usr/bin/env zsh
# unity-open-vscode.sh

# 启动 VSCode CLI,复用同一窗口打开你的工作区,
# 并跳转到 Unity 传过来的 “文件:行:列”
exec "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" \
  --reuse-window ~/projects/projectX.code-workspace \
  --goto "$1:$2:$3"

给它可执行权限:

chmod +x ~/bin/unity-open-vscode.sh

为什么选择 zsh 作为shell 脚本,他的好处可以查看 zsh 适合开发的shell环境安装记录和实践


三、在 Unity 中配置 External Tools

  1. Unity → Preferences… → External Tools

  2. External Script Editor 选择: Browse… → 定位到 ~/bin/unity-open-vscode.sh(或者直接选脚本文件也能出 Args,视版本而定)。

  3. 下方出现 External Script Editor Args,填写:

    $(File) $(Line) $(Column)
    

此后,双击控制台报错或 Assets 面板脚本时,就会执行你的 zsh 脚本, 打开包含前后端的统一 workspace,并跳到对应行。


效果

  1. Unity → 双击脚本 → 触发 unity-open-vscode.sh → VSCode 在你定义的 workspace 里打开,跳到文件与行号。
  2. VSCode → 打开仓库 → 前后端、Unity 代码一览无遗。

通过上述步骤,你就拥有了一套可复用、集中管理的 VSCode + Unity 开发环境,既灵活又高效。

2025.5.19

卧槽,发现个致命问题,不选择vscode,不支持自动生成更新 .csproj 文件,有大神有其他解决方法,请留言教下