VSCode大纲视图仅在当前文件内跳转符号，不切换标签页；跨文件跳转需用Ctrl+Click或F12，依赖语言服务器定义位置；#region是跨语言通用的手动折叠方式。
VSCode 的大纲视图本身不切换标签页，它只在当前打开的文件内跳转符号位置；所谓“通过大纲切换标签页”，本质是误读了功能边界——你真正需要的是「跨文件跳转定义」或「快速打开并定位到某函数」。
Ctrl+Shift+O 只作用于当前文件，不是全局函数搜索
按 Ctrl+Shift+O（macOS 是 Cmd+Shift+O）调出的大纲，列出的全是当前编辑器中已打开文件的符号（函数、类、变量等），点击后光标只在该文件内跳转，不会打开新标签页，也不会切换到其他未打开的文件。
- 如果你看到某个函数名但点不了，大概率是语言服务器没解析成功：检查右下角语言模式是否为正确类型（如
C、Python），而不是Plain Text - 若大纲为空或只有空行，先确认对应扩展已安装并启用（如
C/C++扩展对 C 文件，Pylance对 Python 文件） -
Ctrl+Shift+O不依赖后台索引，即使右下角显示 “Indexing…”，它仍可用；而Ctrl+P @xxx会失败
想跳到其他文件里的函数？用 Ctrl+Click 或 F12
把光标停在函数名上，按 Ctrl+Click（Windows/Linux）或 Cmd+Click（macOS），VSCode 会尝试打开该函数定义所在的文件，并定位到具体行。这依赖语言服务器提供的定义位置（definition range），不是大纲能力。
- 如果跳转失败，90% 是语言服务器返回了非法位置（比如行号为 0、字符偏移负数），可在开发者工具 Console 里看是否有
Invalid range报错 - 对 C 项目，必须配置好
.vscode/c_cpp_properties.json中的includePath和compilerPath，否则连头文件里的函数都找不到定义 - Python 用户若用
venv，务必在 VSCode 中选对解释器（Ctrl+Shift+P→Python: Select Interpreter），否则 Pylance 解析 AST 失败，大纲和跳转全挂
#region 是唯一能手动控制折叠区块且跨语言通用的方式
当语言服务器不稳定，或者你想把配置块、工具函数块、测试用例块强制归类时，#region 和 #endregion 是最可靠的手动折叠标记。VSCode 原生识别，不依赖语法解析，只靠字符串匹配。
- 在 C、C++、Python（需注释形式
#region）、JavaScript 等几乎所有语言中都有效 - 写法示例：
#region API Config→ 中间代码 →#endregion，之后就能用Ctrl+Shift+[/]快速跳转到这些标记行 - 注意：它不会出现在大纲里，只影响折叠区域导航；想让它进大纲，得靠语言服务器把这段识别成符号（比如 Python 里写成 class 或 def）
真正容易被忽略的点是：大纲视图和函数跳转走的是两套机制——前者靠语言服务器提供符号列表（DocumentSymbol），后者靠定义位置（Definition）。同一个函数在大纲里能看见，不代表 F12 一定能跳过去；反过来，Ctrl+Click 能跳，也不代表它一定出现在大纲中（比如局部函数、匿名函数）。别假设它们同步，要分开验证。
