C# Avalonia for Visual Studio 2022插件收费问题

转发，仅作备份。引自：C# Avalonia for Visual Studio 2022插件收费问题 - 罕 - 博客园

🛠️ 告别自动更新：Avalonia for Visual Studio 旧版 (MIT) 本地编译指南

⚠️ 重要提示：从 2025 年 10 月 13 日 起，Visual Studio Marketplace 上的官方 Avalonia 扩展已转为商业授权。如果你希望继续免费使用 .axaml 的实时预览与设计功能，请参照本指南编译最后一个 MIT 协议的版本（ARCHIVE 分支）。

📖 背景故事：为什么要自己编译？

最近打开 Visual Studio，你是否看到了关于 Avalonia 授权的弹窗？这并不是软件出了 Bug，而是 Avalonia 生态的一次重大调整。

• 新旧交替：Avalonia 开发了一个功能更强大的全新 VS 扩展（+ 版本），但这属于商业付费项目。

• 槽点满满的更新策略：官方为了减少对付费用户的沟通成本，复用了旧的扩展包名。这导致老用户被自动更新到了付费扩展上，从而触发了授权验证。

• 好消息：得益于 Devolutions 公司的投资，官方决定对新扩展进行免费评估（约 67% 的开发者符合条件）。但对于不想折腾账号认证或想保持绝对免费的用户来说，ARCHIVE 分支是最稳妥的选择。

📌 原回答来源：https://www.zhihu.com/question/1963385585965176682/answer/1964297846166626519

🚀 准备工作

在开始之前，请确保你的电脑已经安装了以下工具：

• ✅ Visual Studio 2022（社区版即可）

• ✅ .NET SDK（建议安装最新的 LTS 版本）

• ✅ Git（用于克隆源码）

🔧 详细编译步骤

我们将通过编译 ARCHIVE 分支的代码，生成一个属于自己的 .vsix 安装包。

第一步：获取源码

打开命令行（CMD / PowerShell / Git Bash），执行以下命令克隆仓库并切换到 ARCHIVE 分支：

克隆官方仓库

git clone https://github.com/AvaloniaUI/AvaloniaVS.git

进入项目目录

cd AvaloniaVS

切换到最后一个 MIT 协议的归档分支

git checkout ARCHIVE

第二步：打开解决方案

使用 Visual Studio 2022 打开项目根目录下的 AvaloniaVS.sln 文件。

!https://via.placeholder.com/800x450?text=Open+AvaloniaVS.sln

第三步：还原依赖

首次打开时，Visual Studio 通常会自动还原 NuGet 包。
如果没有自动还原，请手动操作：

1. 右键点击解决方案名称 AvaloniaVS。
2. 选择 还原 NuGet 包 (Restore NuGet Packages)。

第四步：选择目标项目

在右侧的“解决方案资源管理器”中，你会看到多个项目：

项目名称 适用环境 推荐度

AvaloniaVS.VS2022 Visual Studio 2022 ⭐⭐⭐⭐⭐ (首选)

AvaloniaVS.VS2019AndEarlier VS2019 及更早版本 ⭐⭐

👉 右键点击 AvaloniaVS.VS2022 项目（这是我们要构建的目标）。

第五步：（可选）修改版本号以避免冲突

为了防止与 Marketplace 上的版本冲突，建议修改版本号。

1. 在 AvaloniaVS.VS2022 项目中找到 source.extension.vsixmanifest 文件。
2. 双击打开它，VS 会显示一个可视化的编辑器。
3. 找到 Version 字段，将其修改为自定义版本（例如：11.6.0-mybuild 或 1.0.0.0）。

💡 为什么要改？

如果不修改版本号，VS 可能会认为这是旧版本而不允许覆盖安装。改个名，比如叫 "AvaloniaVS Community Build"，就能完美共存。

第六步：构建 Release 版本

1. 将顶部的编译配置从 Debug 切换为 Release。
   !https://via.placeholder.com/400x100?text=Switch+to+Release
2. 再次右键点击 AvaloniaVS.VS2022 项目。
3. 选择 生成 (Build)。

等待片刻，看到“成功 1 个”的提示后，即表示编译完成。

第七步：找到并安装 .vsix 文件

编译成功后，你的安装包已经生成好了！

📂 文件路径通常为：

[AvaloniaVS目录]\AvaloniaVS.VS2022\bin\Release\AvaloniaVS.VS2022.vsix

安装方法：

1. 关闭所有 Visual Studio 窗口（非常重要！）。
2. 双击这个 .vsix 文件。
3. 跟随 VSIX 安装向导点击“安装”。
4. 重新打开 Visual Studio，尽情享受无弹窗、无授权的 Avalonia 设计体验吧！🎉

📥 懒人包（直接下载）

如果你不想自己编译，或者编译遇到了困难，可以尝试寻找社区编译好的版本（注意安全风险），或者……

点击查看社区求助方式

❓ 常见问题 (FAQ)

Q: 这样编译出来的版本以后还能用吗？
A: 能用。这是基于 MIT 协议的最后一个稳定版本，只要 Visual Studio 的 API 不发生翻天覆地的变化，它可以一直工作下去。

Q: 以后还会收到自动更新吗？
A: 不会。因为你安装的版本号通常低于现在商店里的商业版，或者因为你自己修改了版本号，VS 不会将其识别为同一个插件进行覆盖更新。

Q: 编译失败了怎么办？
A: 常见解决方法：

1. 确保 VS2022 安装了“Visual Studio 扩展开发”工作负载。

2. 尝试清理解决方案 (Clean Solution) 后再生成 (Build)。

3. 检查 .NET SDK 版本是否符合项目要求。