VSCode插件无法直接“添加”到项目，需全局安装或调试窗口启用；开发时主窗口查不到插件属正常，须打包安装才能在主窗口使用；获取项目路径应优先用vscode.workspace.workspaceFolders，单文件场景回退至activeTextEditor；command注册名三处必须完全一致；engines.vscode版本需兼容目标环境，打包前须在最低支持版本测试。
直接在当前 VSCode 项目里“添加”一个自定义插件，其实不成立——VSCode 插件是全局安装或工作区级启用的独立扩展，不是像 npm 包那样 npm install 到项目目录就能用。你真正要做的，是让这个插件对当前项目生效，或让插件能感知/操作当前项目上下文。
vscode.extensions.getExtension() 查不到刚开发的插件？
本地开发时，插件还没安装到 VSCode 实例里，只存在于你自己的源码目录中。调试窗口（F5 启动的那个新窗口）会自动加载你正在开发的插件，但主编辑器窗口不会。
- 调试期间，所有功能只在弹出的「Extension Development Host」窗口中可用
- 主 VSCode 窗口执行
vscode.extensions.getExtension("your-publisher.your-extension")返回null是正常现象 - 如果想在主窗口使用，必须先打包成
.vsix并手动安装，或发布后从市场安装
如何让插件读取当前打开的项目路径？
插件默认不知道你在编辑哪个项目，需要主动获取工作区信息。关键不是“项目目录”，而是 VSCode 的 workspaceFolders 概念——它可能为空（没打开文件夹）、单文件、或多根工作区。
- 用
vscode.workspace.workspaceFolders获取所有已打开的文件夹路径，第一个通常是主项目：vscode.workspace.workspaceFolders?.[0]?.uri.fsPath - 如果用户只打开了单个文件（没打开文件夹），
workspaceFolders为undefined，此时可用vscode.window.activeTextEditor?.document.uri.fsPath取当前文件所在目录 - 不要硬写相对路径如
./src/config.json，必须拼接fsPath后再用 Node.js 的path.join()构造完整路径
package.json 中 contributes 配置不生效？
常见原因不是语法错，而是命令注册和声明没对上号。VSCode 要求：声明的命令名、注册的命令名、用户触发的命令名，三者必须完全一致（包括大小写和点号位置）。
-
package.json的contributes.commands里写的是"command": "myext.doSomething" -
extension.ts里必须用vscode.commands.registerCommand("myext.doSomething", ...) - 用户在命令面板输入的，也得是
Do Something（标题）或直接搜myext.doSomething（ID） - 漏掉
context.subscriptions.push(disposable)会导致命令注册失败且无报错
插件打包后在目标机器上不运行？
最常踩的坑是 engines.vscode 版本锁得太死，或依赖了高版本 API 但没降级兼容。
- 检查
package.json中"engines": {"vscode": "^1.80.0"}—— 如果用户用的是 1.79.2，插件根本不会加载 - 不要盲目设成
^1.90.0；查 VSCode 官方文档确认你要用的 API（比如vscode.workspace.findFiles的参数变化）最早在哪版支持 -
vsce package失败时，错误信息里若含Unsupported engine，说明版本不匹配，必须改engines.vscode，而不是改本地 VSCode - 打包前务必在最低支持版本的 VSCode 上手动测试核心流程
真正难的不是写代码，而是让插件在别人的 VSCode 里，在各种工作区形态（空窗口、单文件、多根）、各种 VSCode 版本下，稳定拿到它需要的上下文路径和编辑器状态。每一步都要做 fallback，别假设 workspaceFolders 一定存在，也别相信用户装的是最新版。
