用途:判断文件或代码片段属于哪种编程语言,供后续解析或结构提取使用。该包支持 371 种语言。
主要能力与使用方式(CLI):没有独立的 detect 命令,检测在 ts-pack parse 与 ts-pack process 中隐式进行,依据文件扩展名自动识别。例如 ts-pack parse src/app.ts 识别为 typescript,ts-pack process app.py 识别为 python。检测失败时(无扩展名、扩展名歧义或来自 stdin),用 --language 显式指定,如 cat snippet | ts-pack parse - --language go。不解析、仅查询支持情况与缓存状态时使用 list 和 info:ts-pack list --filter type 列出名称含 type 的语言,ts-pack list --manifest 列出远程清单中的全部语言,ts-pack info typescript 查看是否已知、是否已下载及缓存路径。
主要能力与使用方式(SDK):核心提供三个检测函数。detect_language_from_path(path) 依据完整路径(用扩展名);detect_language_from_extension(ext) 依据裸扩展名如 rs;detect_language_from_content(content) 依据原始源码文本,无需路径(例如从 shebang 行判断)。无匹配语法时返回 null/None。Python 可从 tree_sitter_language_pack 导入这三个函数;Node.js/TypeScript 可从 @xberg-io/tree-sitter-language-pack 导入 detectLanguageFromPath、detectLanguageFromContent。
选择建议:已有路径或扩展名且只需一次性处理时,直接用 ts-pack parse/process 自动检测;只有原始内容(粘贴的片段、流、无扩展名文件)时用 SDK 的 detect_language_from_content,必要时再把结果作为 --language 传给 CLI。
限制与衔接:内容检测对无 shebang 等的片段可能无法判断,CLI 不暴露内容检测。确定语言后可交由解析源码或提取代码结构,查看或预取解析器见 managing-parsers。