📋 文档概述

本文档详细介绍如何配置 VSCode 的 Code Runner 扩展，实现 C/C++ 程序的彩色时间戳显示、运行耗时统计、整洁输出界面等优化功能。

一、环境准备与安装

1.1 安装必要软件

  1. VSCode：官网下载
  2. MinGW-w64（Windows）或 GCC（Linux/Mac）：
    # 验证安装
gcc --version
g++ --version
  3. PowerShell 5.1+（Windows 自带）

1.2 安装 Code Runner 扩展

  1. 打开 VSCode
  2. 快捷键 Ctrl+Shift+X 打开扩展商店
  3. 搜索 “Code Runner”
  4. 安装 formulahendry.code-runner

二、基础配置流程

2.1 打开配置文件

  1. 按 Ctrl+Shift+P 打开命令面板
  2. 输入 “Preferences: Open Settings (JSON)”
  3. 选择用户设置文件

2.2 核心配置代码

在 settings.json 中修改以下配置：

{
    // ========== Code Runner 核心设置 ==========
    "code-runner.runInTerminal": true,
    "code-runner.clearPreviousOutput": true,
    "code-runner.preserveFocus": false,
    "code-runner.saveFileBeforeRun": true,
    "code-runner.showExecutionMessage": false,
    "code-runner.ignoreSelection": true,
    
    // ========== 执行器映射配置 ==========
    "code-runner.executorMap": {
        // C语言配置（带彩色时间戳和耗时统计）
        "c": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'yyyy年MM月dd日 HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.c') -ForegroundColor Cyan; gcc '$fileName' -o '$fileNameWithoutExt'; $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\"",
        
        // C++语言配置（带彩色时间戳和耗时统计）
        "cpp": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.cpp') -ForegroundColor Cyan; g++ '$fileName' -o '$fileNameWithoutExt' -std=c++11; $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\"",
        
        // 多文件编译配置（编译当前目录所有C文件，带彩色时间戳和耗时统计）
        "c-multi": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译模式] 多文件编译' ) -ForegroundColor Yellow; gcc *.c -o program -Wall -Wextra; $runStart = Get-Date; .\\program; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""
    }
}

2.3 配置项详解

配置项值作用
runInTerminaltrue在集成终端运行（支持用户输入）
clearPreviousOutputtrue运行前清空终端
preserveFocusfalse运行后聚焦终端（可输入）
saveFileBeforeRuntrue运行前自动保存文件
showExecutionMessagefalse隐藏"【Running】"等消息（仅在输出窗口时有效）
ignoreSelectiontrue总是运行整个文件

三、功能扩展配置

3.1 为不同配置添加快捷键

在 keybindings.json 中添加：

[
    {
        "key": "ctrl+alt+c",
        "command": "code-runner.run",
        "when": "editorLangId == c"
    },
    {
        "key": "ctrl+alt+x",
        "command": "code-runner.run",
        "when": "editorLangId == cpp"
    },
    {
        "key": "ctrl+alt+m",
        "command": "code-runner.runCustomCommand",
        "args": "c-multi"
    }
]

3.2 自定义时间格式

修改 Get-Date -Format 参数：

# 各种时间格式示例
Get-Date -Format 'HH:mm:ss'            # 17:30:45
Get-Date -Format 'yyyy-MM-dd HH:mm:ss' # 2024-12-22 17:30:45
Get-Date -Format 'ddd HH:mm'           # 周日 17:30
Get-Date -Format 'HH:mm:ss.fff'        # 17:30:45.123

3.3 颜色方案定制

可用的 PowerShell 颜色：

颜色代码适用场景
蓝色Blue时间戳、标题
青色Cyan文件信息
绿色Green成功信息、耗时
黄色Yellow警告、编译信息
红色Red错误信息
灰色Gray辅助信息

四、C++ 配置详解

4.1 基础 C++ 配置

"cpp": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.cpp') -ForegroundColor Cyan; g++ '$fileName' -o '$fileNameWithoutExt'; $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""

4.2 带 C++ 标准的配置

"cpp": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.cpp') -ForegroundColor Cyan; Write-Host ('[C++标准] C++11') -ForegroundColor Magenta; g++ '$fileName' -o '$fileNameWithoutExt' -std=c++11 -Wall; $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""

4.3 支持 C++17/20 的配置

"cpp": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.cpp') -ForegroundColor Cyan; g++ '$fileName' -o '$fileNameWithoutExt' -std=c++17 -Wall -Wextra -pedantic; $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""

五、多文件编译配置

5.1 编译当前目录所有 C 文件

"c-multi": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译模式] 多文件编译') -ForegroundColor Yellow; Write-Host ('[文件列表]') -ForegroundColor Cyan; dir *.c | ForEach-Object { Write-Host ('  - ' + $_.Name) }; gcc *.c -o program -Wall -Wextra; $runStart = Get-Date; .\\program; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""

5.2 编译指定文件列表

"c-specific": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译模式] 指定文件编译') -ForegroundColor Yellow; gcc main.c utils.c helper.c -o myprogram -I./include -L./lib -lm; $runStart = Get-Date; .\\myprogram; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green\""

5.3 多文件编译进阶：自动检测头文件依赖

"c-advanced": "cd $dir && powershell -Command \"Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; $files = (Get-ChildItem *.c).Name -join ' '; Write-Host ('[编译文件] ' + $files) -ForegroundColor Cyan; gcc $files -o program -Wall -Wextra -g; if ($LASTEXITCODE -eq 0) { $runStart = Get-Date; .\\program; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green } else { Write-Host '[编译失败]' -ForegroundColor Red }\""

六、运行与测试

6.1 运行方式

  1. 单个文件：右键 → “Run Code” 或 快捷键
  2. 自定义命令：按 Ctrl+Shift+P → 输入 “Run Custom Command”
  3. 终端运行：会自动使用配置的彩色输出

6.2 预期输出示例

[运行时间] 2024年12月22日 17:30:45  ← 蓝色
[编译单元] example.c                 ← 青色
输入一个ASCII码值（如：66）：66
其对应的字符为B
[运行耗时] 1.234s                    ← 绿色

6.3 多文件编译输出示例

[运行时间] 17:30:45                  ← 蓝色
[编译模式] 多文件编译                ← 黄色
[文件列表]                           ← 青色
  - main.c
  - utils.c
  - helper.c
程序运行输出...
[运行耗时] 2.567s                    ← 绿色

七、故障排除

7.1 常见问题

问题原因解决方案
PowerShell 执行策略错误权限限制管理员运行：Set-ExecutionPolicy RemoteSigned
中文乱码编码问题在命令开头添加：chcp 65001 >nul &&
颜色不显示终端不支持确保使用支持 ANSI 颜色的终端
耗时计算不准确变量作用域确保所有时间计算在同一个 PowerShell 会话中

7.2 调试命令

在 VSCode 终端中直接测试 PowerShell 部分：

# 测试彩色输出
Write-Host '[测试] 彩色输出' -ForegroundColor Blue

# 测试时间格式
Get-Date -Format 'yyyy年MM月dd日 HH:mm:ss'

# 测试完整命令
cd "你的目录" && gcc test.c -o test && .\test

7.3 验证配置

  1. 创建测试文件 test.c：
#include <stdio.h>
int main() {
    printf("配置测试成功！\n");
    return 0;
}
  1. 运行查看输出格式是否符合预期

八、高级优化建议

8.1 性能优化

  • 添加编译优化标志：-O2
  • 调试版本：-g
  • 发布版本：-O3 -s

8.2 错误处理增强

"c": "cd $dir && powershell -Command \"try { Write-Host ('[运行时间] ' + (Get-Date -Format 'HH:mm:ss')) -ForegroundColor Blue; Write-Host ('[编译单元] ' + '$fileNameWithoutExt.c') -ForegroundColor Cyan; gcc '$fileName' -o '$fileNameWithoutExt' -Wall -Wextra; if ($LASTEXITCODE -eq 0) { $runStart = Get-Date; .\\'$fileNameWithoutExt'; $runTime = (Get-Date) - $runStart; Write-Host ('[运行耗时] ' + $runTime.TotalSeconds.ToString('F3') + 's') -ForegroundColor Green } else { Write-Host '[编译失败]' -ForegroundColor Red } } catch { Write-Host ('[错误] ' + $_) -ForegroundColor Red }\""

8.3 跨平台兼容

"c": "cd $dir && (if ($IsWindows) { powershell -Command \"...Windows命令...\" } else { bash -c \"echo '[运行时间] $(date '+%H:%M:%S')' && echo '[编译单元] $fileNameWithoutExt.c' && gcc $fileName -o $fileNameWithoutExt && ./$fileNameWithoutExt && echo '[运行耗时] ...'\" })"

九、配置备份与迁移

9.1 导出配置

# 导出 VSCode 设置
code --list-extensions > extensions.txt
Copy-Item "$env:APPDATA\Code\User\settings.json" .\settings_backup.json

9.2 快速部署脚本

创建 setup_coderunner.ps1：

# 安装 Code Runner 扩展
code --install-extension formulahendry.code-runner

# 应用优化配置
$settingsPath = "$env:APPDATA\Code\User\settings.json"
$config = Get-Content $settingsPath -Raw | ConvertFrom-Json
$config | Add-Member -NotePropertyName "code-runner" -NotePropertyValue @{
    runInTerminal = $true
    clearPreviousOutput = $true
    preserveFocus = $false
    executorMap = @{
        c = "cd `$dir && powershell -Command ..."
        cpp = "cd `$dir && powershell -Command ..."
    }
} -Force
$config | ConvertTo-Json -Depth 10 | Set-Content $settingsPath

十、总结

通过以上配置，您将获得：

  1. 整洁的输出界面：隐藏不必要的信息
  2. 彩色时间戳：直观显示运行时间
  3. 精确耗时统计：了解程序实际运行时间
  4. 多文件支持：灵活应对不同项目结构
  5. 快捷键支持：提升开发效率

此配置特别适合教学演示、调试分析、性能测试等场景，让程序运行信息更加直观和专业。

最后更新：2024年12月22日
适用版本：VSCode 1.85+, Code Runner 0.11.8+
测试环境：Windows 10/11 with PowerShell 5.1+

以上内容均由AI总结，仅供实践参考

# vscode
Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

2026企业微信AI Agent实测：7款技术方案对比

会话审计、敏感词管理、聊天质检、敏感行为识别、舆情、属性、词频及竞品分析覆盖服务风险；线索公海、客户、产品、商机、订单、回款、发票和业绩目标则连接销售全过程。快创助手负责快速建运营任务，策略生成把目标拆成方案，智能客服回答系统使用咨询，数据报表处理自然语言查数，AI洞察联合标签、订单和会话分析客户。我们设计了客户筛选、订单关联、销售交接、会话质检和异常恢复任务，配合技术访谈与行业公开资料复核。准备

avatar AI Agent技术社区
cover

如何构建 AI Agent Harness 2.0，让 AI Agent 比 99% 的开发者更工程化

avatar AI Agent技术社区
cover

AI Agent 对比和选型

avatar AI Agent技术社区