CodeTour是VS Code中由Microsoft发布的实用插件，用于创建交互式代码导览。安装后侧边栏出现图标，点击可打开面板并创建导览，命名如“项目启动流程”。在关键文件如src/main.js处添加步骤，支持Markdown描述作用、函数、配置及修改建议。每步高亮代码行并显示注释，便于新人理解。导览保存为.tours目录下的JSON文件，可提交至Git仓库实现共享。支持导出独立包，方便外部分享。进阶功能包括录制语音说明，在复杂逻辑中增强表达；可通过命令跳转至其他tour，形成学习路径。合理使用CodeTour能有效降低项目上手成本，将隐性知识显性化，提升团队协作效率。
CodeTour 是 Visual Studio Code 中一个非常实用的插件，能帮助开发者为项目创建交互式代码导览和教程。通过它，你可以记录代码路径、添加语音或文字说明，让新成员快速理解项目结构与关键逻辑。特别适合团队协作、开源项目引导或教学场景。
安装并启用 CodeTour 插件
在 VS Code 扩展市场中搜索 CodeTour，找到由 Microsoft 发布的官方插件（或社区维护版本），点击安装。安装完成后，侧边栏会出现“CodeTour”图标，点击即可打开控制面板。
启用后，你可以在项目根目录下生成 .tours 文件夹，所有导览记录都会以 JSON 格式保存在这里，便于版本管理与分享。
创建第一个代码导览
点击 CodeTour 面板中的“+”按钮，选择“Create a new tour”，输入导览名称，例如“项目启动流程”。然后开始逐步导航到关键文件，比如 src/main.js 或 app.py。
每到一个关键位置，点击“Record Step”添加说明。你可以：
- 描述该文件的作用
- 指出重要函数或配置项
- 提示常见问题或修改建议
支持 Markdown 语法，可加入代码片段、链接甚至图片增强表达力。
播放与分享导览
创建完成后，点击播放按钮即可按步骤浏览整个导览。每个步骤会高亮对应代码行，并显示你的注释。团队成员可以直接运行这个 tour，无需额外文档就能理解上下文。
如果使用 Git，.tours 目录可以提交到仓库，新人克隆项目后立即使用这些导览。也可以导出为独立包分享给外部用户。
进阶技巧：嵌入语音与循环引用
CodeTour 支持插入音频说明，适合复杂逻辑讲解。在录制步骤时，点击麦克风图标录制语音备注，播放时自动播放。
多个 tour 之间可通过命令跳转，例如在一个 tour 结尾添加“下一步：查看用户认证模块”，点击后自动启动另一个 tour，形成完整学习路径。
基本上就这些。合理使用 CodeTour 能大幅降低项目上手成本，把隐性知识显性化。不复杂但容易忽略。
