新建 VS 扩展必须使用 Visual Studio 自带的 VSIX Project 模板，它预置 Microsoft.VSSDK.BuildTools 引用和 source.extension.vsixmanifest 文件，避免手动配置导致安装失败、图标不显示、命令无响应等问题。
VSIX 项目模板选哪个才不踩坑
新建 VS 扩展，Visual Studio 自带的 VSIX Project 模板是唯一正解。别用 Class Library + 手动改 .csproj，也别套用 ASP.NET 或 WPF 库模板——它们缺 Microsoft.VSSDK.BuildTools 引用、没 source.extension.vsixmanifest 文件，编译后根本装不上。
-
VSIX Project模板默认带VS2022兼容目标（TargetFramework=net6.0），若需支持 VS2019，得手动把TargetFramework改成net472，同时删掉UseWPF和UseWindowsForms属性，否则生成失败 - 模板生成的
source.extension.vsixmanifest里InstalledByMsi必须设为false，否则用户安装时提示“无法安装：已由 MSI 管理” - 扩展图标必须是
Resources\icon.png（20×20 像素，PNG 格式），路径/尺寸错一个，VS 就静默忽略图标
Command 不响应点击？检查 Package 继承和 InitializeAsync
写完 MenuItem 代码，菜单项显示正常但点击无反应，八成是 Package 类没正确初始化命令或没调用基类 InitializeAsync。VS 不会报错，只会静默跳过。
- 确保你的主 Package 类（如
MyCommandPackage）继承自AsyncPackage，不是Package——后者在 VS2022+ 已弃用，且不支持异步初始化 -
InitializeAsync方法里必须显式调用await base.InitializeAsync(cancellationToken, progress)，漏掉这句，所有OleMenuCommand都不会注册到 UI - 命令 ID（
CommandID）里的Guid必须和vsct文件中GuidSymbol的guid完全一致，大小写敏感，复制粘贴时容易多空格或换行
vsct 文件里 Button 放错位置就找不到菜单
vsct 是 VS 扩展的 UI 描述文件，语法严格。Button 显示不出来，大概率是 CommandPlacement 的 id 或 priority 配错了，而不是代码问题。
- 想加到「工具」菜单末尾，
Parent guid用guidSHLMainMenu，ID用IDM_VS_MENU_TOOLS；加到「编辑」菜单下，ID得换IDM_VS_MENU_EDIT——这些常量定义在VisualStudio.Shell.15.0里，不能靠猜 -
priority值越小越靠前，但 VS 有保留区间（比如 0x0000–0x00FF 给内置命令），建议从0x0100开始，避免被覆盖 - 改完
vsct后必须清理bin和obj目录再重编译，VS 缓存.vsct编译结果，改了也不生效
调试时 Extension 加载失败，看 ActivityLog.xml 而不是输出窗口
按 F5 启动实验实例，插件没出现、菜单空白、甚至实验实例直接崩溃——VS 的“输出”窗口基本没用，真正线索藏在 ActivityLog.xml 里。
- 日志路径是
%AppData%\Microsoft\VisualStudio\17.0_xxxx\ActivityLog.xml（VS2022），用浏览器打开，搜索MyCommandPackage或你扩展的Package GUID - 常见错误：
Could not load file or assembly 'Microsoft.VisualStudio.Shell.15.0'表示引用版本和当前 VS 不匹配；SetSite failed多半是ProvideAutoLoad特性里传了错误的UIContext枚举值 - 如果日志里出现
Skipped loading package，说明扩展被禁用或签名验证失败——检查source.extension.vsixmanifest中SupportedProducts的版本号是否包含当前 VS（如[17.0,18.0)）
VS 扩展最麻烦的从来不是写功能，而是让 VS 相信它该加载你。路径、GUID、版本号、XML 标签闭合、缓存清理……任何一环差一点，就卡在“看不见”的地方。动手前先确认 VS 版本和模板目标框架对齐，比写一百行命令逻辑都重要。
