VSIX项目模板选错或配置错误会导致打包失败或运行异常，需选用VSIX Project模板、匹配SDK版本、正确配置.csproj和source.extension.vsixmanifest，并通过ActivityLog.xml排查加载问题。

VSIX 项目模板选错会导致打包失败

新建 VSIX 项目时，必须选 VSIX Project（不是“Class Library”或“Extension”旧模板），且目标框架需匹配你开发插件的 Visual Studio 版本。VS 2022 要求使用 Microsoft.VisualStudio.SDK 17.x+，若引用了 16.x 的 SDK 或混用 Microsoft.VSSDK.BuildTools，msbuild 会静默跳过 .vsix 生成，输出里看不到 Creating vsix... 日志。

检查方法：打开 .csproj，确认存在以下关键项：

<PropertyGroup>
  <TargetFramework>net6.0</TargetFramework>
  <UseWPF>True</UseWPF>
  <IncludeAssemblyInVSIXContainer>True</IncludeAssemblyInVSIXContainer>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="Microsoft.VisualStudio.SDK" Version="17.9.24" />
</ItemGroup>

• VS 2022 推荐用 net6.0 或 net8.0，不用 net472
• IncludeAssemblyInVSIXContainer 缺失会导致 DLL 不进 vsix，安装后命令/菜单全失效
• 若项目含 WPF UI，UseWPF 必须为 True，否则 ResourceDictionary 加载失败

source.extension.vsixmanifest 配置错误直接导致安装失败

这个 XML 文件是 VSIX 的“身份证”，VS 安装器严格校验 ID、Version、DisplayName 和 Prerequisites。常见报错如 The extension cannot be installed because the following prerequisites are missing，基本都是这里填错了。

关键字段说明：

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

• ID 必须全局唯一，建议格式：CompanyName.ExtensionName，不能含空格或下划线
• Version 必须是 x.y.z 格式（如 1.0.0），不能写 1.0 或 1.0.0.0
• Prerequisites 中的 Id 值要和 SDK 文档一致：VS 2022 是 Microsoft.VisualStudio.Component.CoreEditor，不是 Microsoft.VisualStudio.Editor
• Assets 下的 Type="Microsoft.VisualStudio.VsPackage" 对应项，Path 必须指向编译输出的 .dll（如 MyExtension.dll），不是 .vsixmanifest 本身

调试时生成的 .vsix 不包含 PDB 或资源文件

默认 Debug 模式下，VSIX 打包只包含 Release 输出，但开发者常需要调试源码。若没手动配置，.vsix 解压后看不到 .pdb，断点全灰。

• 在 .csproj 的 PropertyGroup 中加：CopyLocalLockFileAssemblies>true
• 对 PDB：添加 <allowedreferencerelatedfileextensions>.pdb</allowedreferencerelatedfileextensions>
• 对图片/资源字典：确保文件属性 Build Action 设为 Content，且 IncludeInVSIX 为 True
• 验证方式：右键项目 → Open Folder in File Explorer → 进入 bin\Debug，检查是否存在 MyExtension.vsix；解压它（改后缀为 .zip），确认 extension.vsixmanifest 和 DLL/PDB 都在根目录

VS 2022 安装插件后命令不出现？检查 ActivityLog.xml

插件安装成功但菜单/快捷键没反应，最有效的排查路径是看 VS 自己的日志：%AppData%\Microsoft\VisualStudio\17.0_xxxx\ActivityLog.xml（17.0 对应 VS 2022）。搜索 Initialize 或你的 ID，常见错误包括：

• Could not load file or assembly 'MyExtension, Version=1.0.0.0...' → source.extension.vsixmanifest 中 Path 写错或 DLL 名拼写不一致
• Failed to load package → Provide* 特性（如 ProvideMenuResource）参数和 .vsct 文件中 guid/id 不匹配
• Package did not load correctly → 构造函数抛异常，或 InitializeAsync 中 await 了未完成的任务（如未用 JoinableTaskFactory）

复杂点在于：VSIX 打包本身不报错，但运行时依赖链断裂——比如一个 Export 类型没被 MEF 正确识别，整个 Package 就不会加载，也不会写任何提示。这时候 ActivityLog 是唯一线索。