故障排查指南索引

使用说明

遇到问题时，请先查阅本目录下的相关文档，很可能已经有解决方案。

已记录的问题

VSCode 扩展相关

• VSCode 扩展在工作区模式下不显示 - 工作区文件配置导致扩展无法激活

构建相关

（待添加）

运行时相关

（待添加）

排查原则

1. 先搜索已有文档 - 使用关键词在本目录搜索
2. 观察现象找规律 - 不同场景下的表现差异往往指向问题根源
3. 检查配置优先级 - 工作区 > 项目 > 用户 > 默认
4. 记录排查过程 - 包括走过的弯路，为后续排查提供经验

文档模板

新建故障排查文档时，请使用以下模板：

# [问题标题]

## 问题描述
- 发现时间：
- 问题现象：
- 影响范围：

## 问题排查过程
### 1. 初始判断
- 尝试方案：
- 结果：

### 2. 进一步分析
- 尝试方案：
- 结果：

### N. 关键发现
- 真正的问题：

## 根本原因

## 解决方案

## 经验教训

## 相关文件

## 参考链接

快速检查清单

遇到 VSCode 扩展问题时：

• [ ] 是否使用工作区文件打开？
• [ ] 检查 .vscode/settings.json 和 .code-workspace 配置是否同步
• [ ] 扩展是否已正确安装？code --list-extensions | grep wtc
• [ ] 重新加载窗口是否解决？

遇到构建问题时：

• [ ] 检查 resource_dirs.json 版本号
• [ ] 运行 scripts/sync_flavor.sh 同步风格
• [ ] 清理缓存目录 .webpcache、publish

维护说明

• 每个问题解决后都应该记录
• 包含完整的排查过程，包括失败的尝试
• 定期整理和分类文档
• 更新索引和快速检查清单