在 VS Code 中开发 Avalonia 应用可行:需安装 .NET SDK、avalonia-cli 工具及 C#、XML Tools 等扩展;用 CLI 创建项目,配置 .vscode/settings.json 关联 .axaml 文件,安装 Avalonia for VS Code 扩展;手动设置 launch.json 和 tasks.json 实现调试运行。

在 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” 环境 - 替换配置为(以默认启动项目为例):
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch MyApp",
"type": "coreclr",
"request": "launch",
"preLaunchTask": "build",
"program": "${workspaceFolder}/MyApp/bin/Debug/net8.0/MyApp.dll",
"args": [],
"cwd": "${workspaceFolder}",
"console": "internalConsole",
"stopAtEntry": false
}
]
} - 再配一个
tasks.json(构建任务),确保按 F5 能自动编译运行
基本上就这些。不需要装臃肿 IDE,也能在 VS Code 里流畅写 Avalonia —— 关键是 CLI 创建 + 正确关联文件类型 + 手动配调试。熟悉后比开 Visual Studio 还快。










