VSCode + Unity 游戏开发环境一键启动流程
核心思想:借助一个 zsh 脚本,把双击 Unity 脚本时的打开操作,定向到你自己管理的 .code-workspace(既包含前端/后端工程,也包含 Unity 项目),并且自动跳到对应文件和行号。
一、准备一个多根工作区文件
在你本地随意目录下创建工作区文件,比如 ~/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
-
Unity → Preferences… → External Tools
-
External Script Editor 选择: Browse… → 定位到
~/bin/unity-open-vscode.sh(或者直接选脚本文件也能出 Args,视版本而定)。 -
下方出现 External Script Editor Args,填写:
$(File) $(Line) $(Column)
此后,双击控制台报错或 Assets 面板脚本时,就会执行你的 zsh 脚本, 打开包含前后端的统一 workspace,并跳到对应行。
效果
- Unity → 双击脚本 → 触发
unity-open-vscode.sh→ VSCode 在你定义的 workspace 里打开,跳到文件与行号。 - VSCode → 打开仓库 → 前后端、Unity 代码一览无遗。
通过上述步骤,你就拥有了一套可复用、集中管理的 VSCode + Unity 开发环境,既灵活又高效。
2025.5.19
卧槽,发现个致命问题,不选择vscode,不支持自动生成更新 .csproj 文件,有大神有其他解决方法,请留言教下