在 VS Code 中开发 Avalonia 应用是完全可行的,虽然它不像 Visual Studio 那样有官方图形化模板支持,但通过命令行工具 + 插件 + 正确配置,可以实现高效、轻量的跨平台 UI 开发。
安装必要工具链
VS Code 本身不内置 .NET 或 Avalonia 支持,需手动准备基础环境:
安装 .NET SDK(建议 6.0 或更高版本),Avalonia 当前主力支持 .NET 6/7/8 安装 Avalonia CLI 工具:dotnet tool install -g avalonia-cli可选但推荐:安装 VS Code 扩展 C# (by Microsoft) 和 XML Tools(方便编辑 .axaml 文件)
创建与打开项目
不要依赖 VS Code 模板插件(目前无稳定 Avalonia 项目模板),而是用 CLI 创建:
终端中运行:avalonia new MyApp(会生成标准 MVVM 结构) 进入项目目录:
cd MyApp在 VS Code 中打开:
code .首次打开时,VS Code 会提示是否恢复 C# 项目,点 “Yes” 即可加载 OmniSharp
启用 AXAML 文件支持
.axaml 是 Avalonia 的 XAML 变体,VS Code 默认不识别语法高亮和智能提示:
在项目根目录添加.vscode/settings.json,写入:
{ "files.associations": { "*.axaml": "xml" } }
安装扩展 Avalonia for VS Code(由社区维护,提供 AXAML 片段、属性补全等基础支持)
重启窗口或重载窗口后,.axaml 文件会有基础高亮和标签闭合提示
调试与运行配置
VS Code 默认没有 Avalonia 启动配置,需手动添加
.vscode/launch.json: 按
Ctrl+Shift+P→ 输入 “Debug: Open launch.json” → 选择 “.NET Core” 环境 替换配置为(以默认启动项目为例):
{<br> "version": "0.2.0",<br> "configurations": [<br> {<br> "name": "Launch MyApp",<br> "type": "coreclr",<br> "request": "launch",<br> "preLaunchTask": "build",<br> "program": "${workspaceFolder}/MyApp/bin/Debug/net8.0/MyApp.dll",<br> "args": [],<br> "cwd": "${workspaceFolder}",<br> "console": "internalConsole",<br> "stopAtEntry": false<br> }<br> ]<br>}
再配一个 tasks.json(构建任务),确保按 F5 能自动编译运行
基本上就这些。不需要装臃肿 IDE,也能在 VS Code 里流畅写 Avalonia —— 关键是 CLI 创建 + 正确关联文件类型 + 手动配调试。熟悉后比开 Visual Studio 还快。
