VS Code插件须通过vscode.workspace API获取目录结构：用workspaceFolders获取根目录，activeTextEditor?.document.uri.fsPath获取当前文件路径，uri.joinPath拼接路径，fs.readDirectory异步遍历，createFileSystemWatcher监听变化，fs.readFile安全读取配置文件。
VS Code 插件如何读取当前工作区目录结构
插件无法直接访问文件系统，必须通过 VS Code 提供的 vscode.workspace API 获取路径信息。常见误区是试图用 Node.js 的 fs 模块同步读取，这在插件主进程（extension host）中会失败或被沙箱拦截。
- 获取根目录：使用
vscode.workspace.workspaceFolders—— 返回WorkspaceFolder[]，为空说明未打开文件夹 - 获取活动编辑器所在文件路径：用
vscode.window.activeTextEditor?.document.uri.fsPath，注意可能为undefined - 路径拼接务必用
vscode.Uri.joinPath()，而非字符串拼接，避免 Windows/Linux 路径分隔符差异 - 若需遍历子目录，必须调用
vscode.workspace.fs.readDirectory()（异步），不能用fs.readdirSync
为什么插件里调用 require('fs') 会报错
VS Code 插件运行在受限的 Node.js 环境中，fs、child_process 等原生模块默认不可用，除非显式启用 nodeIntegrationInWorker: true（不推荐）或改用 vscode.workspace.fs 提供的封装 API。
-
vscode.workspace.fs是唯一安全、跨平台的文件系统接口，支持readFile、writeFile、createDirectory、delete等操作 - 所有路径参数必须是
vscode.Uri类型，传入字符串会直接抛出TypeError: Invalid URI - 权限限制：插件无法访问用户家目录外的路径（如
/etc或C:\Windows），尝试访问会静默失败或抛出EPERM
如何监听目录变化并触发插件逻辑
直接轮询效率低且耗资源，正确做法是注册 vscode.workspace.createFileSystemWatcher()，它基于操作系统原生事件（inotify / kqueue / FindFirstChangeNotification）实现低开销监听。
- 通配符写法必须用
**表示递归，例如**/*.ts；单个*只匹配当前层级 - Watcher 默认不监听子目录新建/删除事件，需手动监听
onDidCreate和onDidDelete并递归注册新 Watcher - 务必在插件
deactivate()中调用dispose()，否则残留监听器会导致内存泄漏和重复触发 - 注意事件延迟：文件重命名可能触发
onDidDelete+onDidCreate两个事件，需用setTimeout合并判断
插件中解析 package.json 或 tsconfig.json 的安全方式
不要用 require() 动态加载项目配置文件，这会绕过 VS Code 的沙箱机制并引发安全警告；应统一走 vscode.workspace.fs.readFile() → TextDecoder → JSON.parse() 流程。
- 读取后需做 try/catch，配置文件语法错误会导致
JSON.parse()抛出异常 - 路径构造示例：
vscode.Uri.joinPath(workspaceFolder.uri, 'package.json') - 若需类型校验（如确认
package.json含scripts.build），建议用zod或io-ts做运行时 schema 检查，避免字段缺失导致插件崩溃 - 缓存策略：对频繁读取的配置文件，可用 Map 缓存
Uri→ParsedContent映射，但需监听对应文件的onDidChange事件更新缓存
实际开发中最容易忽略的是 Watcher 的生命周期管理和配置文件读取的异常分支——很多插件在用户删掉 tsconfig.json 后直接报错退出，而不是优雅降级。
