proofgeneral/coq-emacs

Coq-Emacs-Proof General Docker镜像

镜像概述

本Docker镜像集成了Coq证明辅助系统、Emacs文本编辑器及Proof General插件，旨在提供一个一致、隔离的环境，用于运行、测试和开发Proof General——一款用于Coq交互的Emacs插件。镜像预配置了必要的依赖和环境变量，避免了本地系统配置差异导致的兼容性问题，确保用户可快速上手使用Proof General进行Coq证明开发。

核心功能与特性

• 组件集成：包含Coq（证明辅助系统）、Emacs（文本编辑器）及Proof General（Emacs插件，实现Coq交互式开发），无需手动安装配置。
• 即开即用：预配置Proof General与Coq的关联，启动Emacs即可直接使用Proof General功能。
• 环境一致性：标准化运行环境，消除因操作系统、依赖版本差异导致的功能异常。
• 轻量级隔离：基于精简基础镜像构建，兼顾功能完整性与资源效率。

使用场景

• Proof General开发测试：为Proof General插件开发者提供一致的测试环境，验证新功能或修复兼容性问题。
• Coq证明脚本开发：用于编写、调试Coq证明脚本，支持通过Proof General的交互式界面逐步执行证明步骤。
• 教学与演示：在教学场景中快速部署统一环境，避免学生因本地配置问题影响学习进度。
• CI/CD集成：可作为自动化测试环境，在持续集成流程中验证Coq证明脚本的正确性。

使用方法

1. 拉取镜像

假设镜像名称为coq-emacs-proofgeneral，从Docker Hub或私有仓库拉取：

bash
docker pull [镜像仓库地址]/coq-emacs-proofgeneral:latest

2. 运行容器

2.1 终端模式（无图形界面）

若需在终端中使用Emacs（通过-nw参数启用终端模式）：

bash
docker run -it --rm \
  -v $(pwd):/workspace \  # 挂载本地目录到容器内/workspace（可选）
  [镜像仓库地址]/coq-emacs-proofgeneral:latest \
  emacs -nw /workspace/your_coq_file.v  # 直接打开本地Coq文件

2.2 图形界面模式（需X11转发）

若需使用Emacs图形界面（依赖宿主机X11服务，适用于Linux/macOS）：

bash
# Linux系统（确保xhost允许本地连接）
xhost +local:root

docker run -it --rm \
  -e DISPLAY=$DISPLAY \  # 传递宿主机DISPLAY环境变量
  -v /tmp/.X11-unix:/tmp/.X11-unix \  # 挂载X11 socket
  -v $(pwd):/workspace \  # 可选：挂载本地文件目录
  [镜像仓库地址]/coq-emacs-proofgeneral:latest \
  emacs /workspace/your_coq_file.v  # 启动图形界面Emacs并打开文件

3. 容器内基本操作

• 启动Proof General：在Emacs中打开.v后缀的Coq文件（如example.v），Proof General会自动激活，界面底部显示Coq交互缓冲区。
• 执行证明步骤：使用Proof General快捷键（如C-c C-n执行下一步，C-c C-u回退）与Coq交互，编写或调试证明脚本。

配置说明

挂载本地文件

通过-v参数挂载本地目录至容器内（如/workspace），可直接编辑本地Coq文件，容器内修改会实时同步至宿主机：

bash
docker run -it --rm -v /path/to/local/coq_files:/workspace [镜像名] emacs -nw /workspace/file.v

自定义Emacs/Proof General配置

如需覆盖默认配置，可挂载本地Emacs配置文件（如.emacs或.emacs.d）：

bash
docker run -it --rm \
  -v ~/.emacs.d:/root/.emacs.d \  # 挂载本地Emacs配置目录
  -v $(pwd):/workspace \
  [镜像名] emacs -nw /workspace/file.v

环境变量（可选）

• COQ_VERSION：容器内预装的Coq版本（镜像构建时固定，运行时不可修改，可通过coqtop --version查看）。
• DISPLAY：仅图形界面模式需设置，用于X11转发（默认从宿主机继承）。

注意事项

• 图形界面依赖：图形界面模式需宿主机安装X11服务（Linux默认支持，macOS需安装XQuartz），Windows需通过WSL2或第三方X服务器（如VcXsrv）。
• 权限问题：挂载本地目录时，容器内用户（默认root）可能对宿主机文件有写权限，建议仅挂载非敏感目录。
• 镜像更新：定期拉取latest标签镜像以获取Coq、Emacs或Proof General的版本更新。