Code Runner Pro

运行代码片段或整个文件，覆盖 50 多种语言，并且支持 docx / exe / pdf 这类非文本文件。

本项目是 formulahendry/vscode-code-runner（作者 Jun Han，MIT）的 fork。 配置键沿用 code-runner.*（已有配置零迁移），命令 ID 独立为 crun.*（可与原版共存，不会互相抢占）。 English: README.en.md

相比原版多出来的能力

基本用法

多选区运行

用 Alt 点击 / Alt 拖选选中多处，然后运行：所有非空选区会按文档顺序原样拼接成一个临时文件，不做任何上下文注入。需要 #include、命名空间、前面的类型定义时，把它们一起选上就行 —— 由你决定拼接什么，比工具猜依赖可靠得多。

multiSelectionMode 设为 primary 可退回原版行为（只用主选区）。

选区运行的临时文件

• 后缀完全沿用原文件后缀（无后缀的文件就生成无后缀的临时文件），因此临时文件与原文件行为一致：原文件跑不了，临时文件也跑不了，那说明配置有问题，直接修配置。
• temporaryFileName 控制基名（默认 tempCodeRunnerFile）。
• deleteTempFileAfterRun（默认开）跑完删除；终端模式下会在同一个 shell 里紧接着追加一条删除命令。
• showTempCode 打开后会把生成内容打印到 Code Runner Pro 输出面板，便于核对。

匹配顺序

前一步命中就停止，默认按 "具体优先" 排列：

shebang → glob → extension → language → default

matchOrder 就是一个字符串，用逗号或空格分隔，可以整体改写；留空表示使用默认顺序：

// 默认（具体优先）
"code-runner.matchOrder": "shebang, glob, extension, language, default"

// 回到上游语义（语言先于后缀）
"code-runner.matchOrder": "shebang, glob, language, extension, default"

未列出的步骤会自动按默认顺序补在末尾；非法项与重复项被忽略。不确定某个文件走了哪一步？跑一次 解释当前文件是怎么被匹配的。

典型坑：把 .asm 和 .x64.s 都关联到 assembly 语言后，executorMap["assembly"] 会把 .x64.s 截胡 —— 让 extension 排在 language 前面（默认如此）即可。

配置

三张表

多命令

"code-runner.executorMapByFileExtension": {
  ".docx": [
    { "label": "转 Markdown", "description": "同目录", "command": "pandoc $fullFileName -o $fileNameWithoutExt.md" },
    { "label": "转 PDF", "description": "soffice", "command": "soffice --convert-to pdf $fullFileName" }
  ]
}

命中多条时的行为由 multiActionBehavior 决定：pick（默认，弹选择且上次的置顶）、last（直接用上次）、first（直接用第一条）。

变量

$fileName $fileNameWithoutExt $fullFileName $dir $dirWithoutTrailingSlash $workspaceRoot $pythonPath $driveLetter

（与原版一致；$dir、$dirWithoutTrailingSlash、$fullFileName 会自动加引号。）

常用配置

全部 26 个配置项的说明都能在 VS Code 设置里看到（跟随显示语言）。常见几个：

与上游原版的兼容性

支持的语言

C, C++, Java, JavaScript, PHP, Python, Perl, Ruby, Go, Lua, Groovy, PowerShell, BAT/CMD, BASH/SH, F#, C#, VBScript, TypeScript, CoffeeScript, Scala, Swift, Julia, Crystal, OCaml, R, AppleScript, Elixir, VB.NET, Clojure, Haxe, Objective-C, Rust, Racket, Scheme, AutoHotkey, AutoIt, Kotlin, Dart, Free Pascal, Haskell, Nim, D, Lisp, Kit, V, SCSS, Sass, CUDA, Less, Fortran, Standard ML, Zig, Mojo, Erlang, Gleam …以及自定义命令。

致谢与许可

• 上游项目：formulahendry/vscode-code-runner，作者 Jun Han，MIT 许可。
• 本 fork 同样以 MIT 许可发布；上游的版权声明保留在 LICENSE 中。
• 图标为本项目自制，不使用上游的品牌图形。