用途:在说明代码、调试、代码审查、导航 TODO、引用文档或教学时,把用户精确带到文件的具体行(可选列)位置。
主要能力:通过 code CLI 按行/列打开文件;支持一次指定多个位置;支持新窗口(-n)或复用窗口(-r)。
基本用法: code -g src/publisher.py:36 code -g path/to/file.js:42:10 多位置:code -g src/publisher.py:36 -g src/subscriber.py:45 新窗口:code -n -g file.js:10 复用窗口:code -r -g file.js:10
行号从 1 开始,列号从 0 开始。相对路径从当前工作目录解析,绝对路径更可靠;含空格的路径需加引号。使用前建议先校验文件存在,例如:if [[ -f "path/to/file.js" ]]; then code -g path/to/file.js:42; else echo "File not found"; fi。
适用场景:讲解实现细节、指出错误位置、高亮待处理行、打开 TODO(human) 等任务标记、展示配置或文档片段、教学实操引导。
限制:若路径不存在,VSCode 会创建空文件,位置在用户开始编辑时应用。更多细节见 references/cli_basics.md、references/advanced_usage.md、references/troubleshooting.md、references/integration_patterns.md。