开源工具 · 零配置 · 内置 Vim 开发环境

run 工具

一键编译运行 C 程序（单文件 / 多文件 / .run 列表），自带代码格式化与 Vim 快捷键生态。

⚡安装

Run 已停止更新，最新地址：https://ck.chaokyrie.asia/

一行命令完成安装，自动配置 PATH、Vim 环境与代码格式化：

bash 
$ curl -fsSL https://chaokyrie.asia/install.sh | bash && source ~/.bashrc

安装内容包含：

安装路径：~/.local/bin/run，自动追加 PATH 到 ~/.bashrc

🗑️卸载

安全卸载，清理工具文件、PATH 配置与 Bash 补全：

bash 
$ run --uninstall && source ~/.bashrc

📖用法

bash 
run <源文件.c> [源文件.c ...] [-o 输出名] [-w] [-auto] [-c] [gcc选项 ...] [-- 程序参数 ...]
run <列表.run> [-o 输出名] [-w] [-auto] [-c] [gcc选项 ...]
run <目录> -w            # 用 vim -p 打开目录下所有 .c
run format [文件...]      # 格式化 .c / .h（使用 ~/.clang-format）
run fmt    [文件...]      # format 简写
run -/<可执行文件>         # 直接执行 ./run/ 下的编译产物
run clean                 # 删除 ./run 目录
run --knr                 # 切换代码风格为 K&R
run --allman              # 切换代码风格为 Allman
run --compact             # 切换代码风格为 Compact
run --strict              # 切换代码风格为 Strict
run --version             # 显示版本
run --help                # 显示帮助
run --update              # 更新到最新版（同步更新 vimrc / clang-format / 补全）
run --uninstall           # 从系统卸载
命令说明
run hello.c编译 hello.c → ./run/hello 并执行
run main.c utils.c algo.c多文件编译 → ./run/main（默认输出名 = 第一个 .c）
run demo.run编译 .run 列表内所有文件 → ./run/demo
run test.c -o myout编译 test.c → ./run/myout 并执行
run hello.c -std=gnu99覆盖编译标准（默认 c11，可用环境变量 RUN_STD 设置）
run hello.c -w用 vim 打开 hello.c，不编译不运行
run main.c utils.c -w用 vim -p 标签页打开多个文件
run ./demo -w用 vim -p 打开目录下所有 .c
run format格式化当前目录所有 .c .h（使用全局 ~/.clang-format）
run format test.c util.h格式化指定文件
run --knr切换为 K&R 风格：{ 在行尾，短语句保持单行
run --strict切换为 Strict 风格：{ 独占一行，短语句拆开换行
run clean删除整个 ./run 目录
run --version / -v显示版本及 Logo
run --help / -h显示完整帮助信息
run --update从远程下载最新版本并更新（含补全脚本）
run --uninstall从系统卸载（删除文件、清理 PATH 与补全）

🚀使用示例

1. 查看版本

bash 
$ run --version

  ██████╗██╗  ██╗ █████╗  ██████╗
 ██╔════╝██║  ██║██╔══██╗██╔═══██╗
 ██║     ███████║███████║██║   ██║
 ██║     ██╔══██║██╔══██║██║   ██║
 ╚██████╗██║  ██║██║  ██║╚██████╔╝
  ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝
           v1.3.1-beta

2. 编写并运行

创建 demo.c：

c 
#include <stdio.h>
int main() {
    printf("Hello, run!\n");
    return 0;
}

一键编译运行：

bash 
$ run demo.c
[编译] demo.c → ./run/demo
[运行] ./run/demo
---
Hello, run!
---

3. 代码格式化

一键格式化当前目录所有 C 源文件和头文件（全局配置，任何目录通用）：

bash 
$ run format
[run] 格式化: *.c *.h
  ✓ main.c
  ✓ utils.h

4. 切换代码风格

随时切换大括号风格，全局生效。点击标签快速跳转到对应示例：

K&R Allman Compact Strict

K&R 风格

{ 在行尾，短语句保持单行：

c 
int main(){
    if (head == NULL) return NULL;
    while (*dest++ = *src++);
    for (int i = 0; i < n; i++) {
        if (arr[i] > max) max = arr[i];
    }
    return 0;
}

终端：run --knr  |  Vim：:StyleKnr

Allman 风格

{ 独占一行，短语句保持单行：

c 
int main()
{
    if (head == NULL) return NULL;
    while (*dest++ = *src++);
    for (int i = 0; i < n; i++)
    {
        if (arr[i] > max) max = arr[i];
    }
    return 0;
}

终端：run --allman  |  Vim：:StyleAllman

Compact 风格

{ 在行尾，短语句拆开换行：

c 
int main(){
    if (head == NULL)
        return NULL;
    while (*dest++ = *src++);
    for (int i = 0; i < n; i++) {
        if (arr[i] > max)
            max = arr[i];
    }
    return 0;
}

终端：run --compact  |  Vim：:StyleCompact

Strict 风格

{ 独占一行，短语句拆开换行：

c 
int main()
{
    if (head == NULL)
        return NULL;
    while (*dest++ = *src++);
    for (int i = 0; i < n; i++)
    {
        if (arr[i] > max)
            max = arr[i];
    }
    return 0;
}

终端：run --strict  |  Vim：:StyleStrict

5. 多文件编译

一次编译多个源文件，默认输出名取第一个 .c：

bash 
$ run main.c utils.c algo.c
[编译] main.c utils.c algo.c → ./run/main
[运行] ./run/main
---
Hello, run!
---

6. .run 列表编译

创建 demo.run，每行一个 .c 文件名（支持 # 注释和空行）：

text 
# 主程序
main.c

# 工具模块
utils.c
algo.c

一键编译列表内所有文件：

bash 
$ run demo.run
[编译] main.c utils.c algo.c → ./run/demo
[运行] ./run/demo
---
Hello, run!
---

7. Bash 补全

安装后自动启用 Bash 补全，支持两种补全场景：

bash 
$ run -/demo<Tab>
$ run -/demo       # 直接执行 ./run/demo

⌨️Vim 快捷键（安装后自动生效）

安装脚本会自动配置 ~/.vimrc，打开任意 .c / .h 文件即可使用：

格式化风格由全局 ~/.clang-format 统一控制，任何目录下 F3 / run format 行为一致。

⬆️更新

执行以下命令自动从远程更新到最新版本（会询问是否同步更新 Vim 配置与格式化配置）：

bash 
$ run --update && source ~/.bashrc

也可重新执行安装命令覆盖安装：

bash 
$ curl -fsSL https://chaokyrie.asia/install.sh | bash && source ~/.bashrc
如发现 Bug，请发送邮件至 chao893760@163.com

✨特性

🛠️环境要求