用途:查找并显示最近一次 Code OSS 或 Agents 应用开发运行的日志,用于排查启动崩溃、扩展、Copilot/智能体、MCP、终端、网络与设置同步等问题。
日志位置:默认用户数据目录为 $HOME/.vscode-oss-dev,日志在 $HOME/.vscode-oss-dev/logs/。若启动时使用 --user-data-dir=<dir>,则改用 <dir>/logs/;启动与调试辅助工具常在 .build/ 下创建临时用户数据目录,已知时应优先使用启动命令中的确切目录。每次运行生成时间戳文件夹(如 20260330T163430),按修改时间排序最新的通常最相关。
主要能力:每个时间戳目录包含 main.log(Electron 主进程)、agenthost.log(智能体宿主、模型列表、会话)、mcpGateway.log、sharedprocess.log、telemetry.log、terminal.log、ptyhost.log、network-shared.log、editSessions.log、userDataSync.log、remoteTunnelService.log;window1/ 等窗口目录含 renderer.log、network.log、views.log、notebook.rendering.log、customizationsDebug.log、mcpServer.*.log,以及 exthost/(exthost.log、extHostTelemetry.log、按扩展分目录)和 output_<timestamp>/(tasks.log、agentSessionsOutput.log、agenthost.<clientId>.log)。同一会话内每次窗口重载会新建 output_ 与 exthost/output_logging_ 目录,会话级时间戳目录不变。
使用方式:先确认是 Code OSS 还是 Agents 应用,不确定则都查;用 ls -lt "$HOME/.vscode-oss-dev/logs" | head -5 找最新目录;进入后按问题类型读取对应文件,可用 tail -50 查看近期条目,用 rg -n "MY_PROBE|error" 过滤。云沙箱启动失败先看 renderer.log,关注 [CloudSandboxApi]、[WebPubSubRelayTransport]、[RemoteAgentHostProtocol] 记录。
限制:并非所有日志文件都有内容,许多为空;window1/ 为第一个窗口,多窗口会有 window2/ 等;日志行格式为 YYYY-MM-DD HH:MM:SS.mmm [level] message。临时 console.log 探针不得提交,需持久化应使用 ILogService;启用开发控制台转发需临时修改 src/vs/platform/log/common/log.ts 中的 isDevConsoleLogForwardingEnabled,完成前必须恢复默认关闭并移除所有临时探针。