CCS Theia 和 VS Code搜索插件Multiline Structural Code Search

1.安装搜索插件，Multiline & Structural Code Search

CCS Theia 和 Visual Studio Code 安装方式相同

2.单个项目搜索

安装好后左侧工具栏上有个CQ图标，点击可打开搜索界面，输入需要搜索的关键词，点击搜索即可

3.搜索指定项目

如下图，同时打开了2个项目,Master_ ,SLAVE_, 如果不设置搜索项目，搜索时会把管理器中所有的项目文件中的关键词都搜索出来

a.搜索指定工程和目录（方法1）

设置搜索指定文件夹，添加格式： 项目名/目录名/** (说明：** 表示上级目录下的所有文件 )

如：SLAVE_/** ,表示搜索 SLAVE_ 项目的所有文件

如：SLAVE_/source/** ,表示搜索 SLAVE_ 项目下的 source 目录中的所有文件

添加指定搜索目录后，就能只在指定的目录范围内搜索

b.搜索指定工程和目录（方法2）

项目的资源管理器中，右键点击需要搜索的工程 > 点击 CQ 的搜索菜单

在项目下的文件夹下搜索，对文件夹右键点击 > 点击 CQ 的搜索菜单

4.多项目搜索补充

在 VS Code 多项目（多根工作区）中，CodeQue（Multiline & Structural Code Search）可通过指定搜索目录、工作区配置、右键目录搜索三种方式，精准限定搜索范围。

一、单次搜索：指定目录（最常用）

打开 CodeQue 搜索面板后，直接在Files to include输入目标路径，即可只搜指定项目 / 目录。

操作步骤

1. 打开 CodeQue 搜索面板：
   • 快捷键：Ctrl+Shift+P→ 输入CodeQue: Search
   • 或右键代码 →CQ: Open Search
2. 在搜索面板的Files to include输入框填写路径：
   • 单项目目录：project-a/src/**（只搜 project-a 下 src）
   • 多项目目录：{project-a/src,project-b/lib}/**（同时搜两个目录）
   • 仅当前打开文件所在目录：${fileDirname}/**
3. 填写查询内容，选择模式（如include），点击Search

路径示例（多项目场景）

# 只搜 project1 的 src project1/src/** # 搜 project1/src 和 project2/lib {project1/src,project2/lib}/** # 排除 node_modules、dist **/src/**,!**/node_modules/**,!**/dist/**

二、多根工作区：配置默认搜索范围

若你常用固定几个项目，可在.code-workspace中设置默认路径，避免每次手动输入。

1. 保存多根工作区

• File → Save Workspace As...→ 保存为my-workspace.code-workspace
• 编辑该文件，添加folders与settings：

{ "folders": [ { "path": "../project-a" }, { "path": "../project-b" }, { "path": "../project-c" } ], "settings": { // CodeQue 默认只搜索 project-a/src 和 project-b/lib "codeque.filesToInclude": "{project-a/src,project-b/lib}/**", "codeque.filesToExclude": "**/node_modules/**,**/dist/**,**/*.test.*" } }

2. 生效方式

• 关闭并重新打开该.code-workspace
• 后续打开 CodeQue 时，Files to include会自动加载上述配置

三、右键目录搜索（最快）

在 VS Code 资源管理器中，右键目标文件夹 → CQ: Search in Directory，CodeQue 会自动将该目录填入Files to include，直接搜索。

四、CLI 批量搜索（多项目脚本）

若需在命令行 / CI 中跨项目搜索，用 CodeQue CLI 指定路径：

# 全局安装 CLI npm install -g @codeque/cli # 只搜 project-a/src codeque search "your query" --path ../project-a/src --mode include # 同时搜两个项目 codeque search "your query" --path ../project-a/src,../project-b/lib --mode include

五、常见问题与最佳实践

1. 搜索范围不生效

   • 检查路径是否正确：多项目需写相对.code-workspace的路径
   • 清空Files to exclude或确保不冲突
   • 重启 VS Code 或重新加载工作区

2. 最佳实践

   • 多项目优先用多根工作区 +.code-workspace配置
   • 临时搜索用Files to include或右键目录搜索
   • 批量 / 自动化用CLI