CP Editor – 设置

Docs: 代码编辑

Mon, 01 Jan 0001 00:00:00 +0000

缩进宽度

设置制表符的宽度或缩进的空格个数。该选项设置的值将同时对自动缩进和将制表符替换为空格产生影响。

光标宽度

以像素计算的光标宽度。

自动缩进

当代码另起一行时，该行将和上一行拥有相同的缩进。
如果上一行以 { 结束，该行将会插入一个额外的缩进（一个制表符或缩进宽度个空格，取决于将制表符替换为空格选项是否开启）。

文本自动换行

如果某一行的字符数超出了屏幕的宽度，则该行的内容将会折成多行显示。

自动补全括号

在输入左括号时自动插入右括号。例如，当你输入一个 ( 时，将会自动加入一个 )。

如果光标处右边的第一个字符是右括号，而你输入了一个右括号，光标将会自动跳到该右括号后面，而不再输入右括号。

你可以在各语言的括号设置中设置各语言自动补全的括号类型。

自动删除括号

在删除一个左括号时，如果其右侧有一个右括号相邻，则该右括号也会被自动删除。

你可以在各语言的括号设置中设置各语言自动删除的括号类型。

在按下 Tab 键时跳出括号

如果光标处右边的第一个字符是右括号，你可以通过按下 Tab 键来自动跳出这对括号。如果自动补全括号选项被启用，这种方式可以作为输入右括号的另一种方式。

你可以在各语言的括号设置中设置各语言按下 Tab 时自动跳出的括号类型。

将制表符替换为空格

当插入一个缩进时，插入与缩进宽度数目相等的空格来代替制表符。

该设置不会影响文件中已经存在的空格。在自动缩进选项中，如果上一行使用了制表符作为缩进，新的一行仍然会使用制表符缩进。但如果上一行以 { 结束，新的一行插入的额外缩进将会使用空格。

Docs: 语言

Mon, 01 Jan 0001 00:00:00 +0000

通用

默认编程语言

设置打开新标签时使用的默认编程语言。

命令

C++ 命令

C++ 编译命令

设置编译 C++ 时的编译命令，例如 g++ -Wall。

该命令中不应包含源代码和输出文件的名称，CP Editor 将会自动添加它们。

详细的编译选项请参考编译器的文档。

C++ 可执行文件路径

设置可执行文件的路径，即编译命令中 -o 选项后的参数。

如果使用了相对路径，则可执行文件的位置将和源代码位置有关（如果当前标签是未命名标签，则可执行文件位置将和临时文件夹的位置有关）。

该设置中，你可以使用如下参数：

${filename}：源代码的完整文件名。如果当前标签是未命名标签，则完整文件名是 sol.cpp。
${basename}：将 ${filename} 去掉扩展名（.cpp 等）后的文件名。
${tmpdir} 或 ${tempdir}：临时文件夹的路径。

例如，使用 ${tmpdir}/${basename} 将会把可执行文件存储在临时文件夹下。如果你不想要存储可执行文件的话，可以这样设定路径。而 executables/${basename} 将会把可执行文件存储在源代码所在目录的下的 executables 文件夹。

C++ 运行参数

设置执行 C++ 程序需要的参数。在算法竞赛中一般留空即可。

C++ 编译器输出编码

设置当编译器输出警告，错误等消息时使用的编码。

如果输出的警告和错误信息不是英文，合理配置该设置可以避免输出信息出现乱码。

Java 命令

Java 编译命令

设置编译 Java 源代码的编译命令，例如 javac。

该命令中不应包含源代码和类路径，CP Editor 将会自动添加它们。

Java 类路径

设置编译后存储 Java 类文件的位置。

更多细节详见 C++ 可执行文件路径。

Java 类名称

设置你的源代码中主类的名字。

源代码的名字不必与主类名相同。当编译时，CP Editor 将会自动将源代码保存在一个与主类名称相同的文件中。

Java 运行命令

设置执行 Java 程序时的命令。例如 java。

该命令中不应出现类路径或类名，CP Editor 会自动添加它们。

Java 运行参数

设置执行 Java 程序需要的参数。在算法竞赛中一般留空即可。

Java 编译器输出源码

详见 C++ 编译器输出编码。

Python 命令

Python 运行命令

设置运行 Python 源代码的命令。一般为 python，python2 或 python3。

Python 运行命令

设置执行 Python 程序需要的参数。在算法竞赛中一般留空即可。

模板

如果设置了模板，在创建新标签时，将会用设置的模板自动填充内容。

模板路径

设置模板所在的路径。

使用模板时的光标初始位置

设置使用模板时光标所在的初始位置。

该设置包含三部分。

正则表达式
偏移类型：开头或末尾。
偏移量：一个数字，可以为负值。

光标位置将会通过如下步骤确定：

找到模板中匹配正则表达式的第一个位置。
如果模板中不存在匹配正则表达式的位置，光标将会在模板末尾。
否则，光标将会在第一个匹配位置的开头或末尾（取决于设置的偏移类型），并会在该位置基础上向右移动偏移量个位置（如果是负数，就会向左移动）。

例如，如果你的模板中包含下列代码片段：

int main()
{

}

则可以用 int main 作为匹配的正则表达式，end 作为偏移类型，9 作为偏移量，则在打开一个新标签时，光标将会停在 main 函数的第一行。

代码片段

管理代码片段

你可以在 “语言->XXX->XXX 代码片段中” 添加，删除，重命名代码片段。你可以使用 Ctrl+N 作为添加的快捷键，Ctrl+W 作为删除的快捷键，F2 作为重命名的快捷键。

你也可以在 “更多” 菜单中导入或导出代码片段。

使用代码片段

你可以通过 “动作->使用代码片段” 或按下 Ctrl+T 来使用代码片段。

当你在挑选代码片段时，你可以在搜索框中输入代码片段名的前几个字符，以更快找到相应的片段。

括号

你可以为各编程语言设置相应的括号补全选项。

每个设置有三种状态：开启，关闭或默认。如果处于默认状态，将应用代码编辑中的设置，否则将会使用这里的设置。

Docs: 外观

Mon, 01 Jan 0001 00:00:00 +0000

通用

界面语言 (UI Language)

UI 中使用的自然语言。

界面风格

用户界面使用的样式。可用选项在不同平台上有所不同。

“默认”样式要么是在你的平台上最合适的样式，要么是 --style 命令行选项指定的样式。

在 Windows 上，还有一个附加选项 “Auto Fusion”。“Auto Fusion” 是深色还是浅色取决于系统主题（即 Windows 应用程序主题是深色还是浅色）。

更改 UI 样式后，如果有任何问题，可以尝试重新启动 CP Editor。

编辑器主题

代码编辑器的语法高亮显示主题。

不透明度

主窗口的不透明度。

测试用例最大高度

滚动条出现之前测试用例的最大高度。

只显示编译并运行

隐藏仅编译、仅运行这两个按钮。

如果你不在乎编译所用的时间，这或许会有用。

在差异查看器中显示行尾字符

使用字符 “¶” 在差异查看器中可视化行尾。如果你要查看行尾的差异（即末尾多余的空行），这将很有用。

在代码编辑器底部添加额外的边距

在代码编辑器的底部添加一个额外的边距，让你可以更少地滚动。

字体

仅显示等宽字体

在为下面的设置选择字体时只显示等宽字体。

使用自定义的全局字体

对 UI 用自定义字体（代码编辑器，测试用例，消息等除外）来替代系统字体。

Docs: 动作

Mon, 01 Jan 0001 00:00:00 +0000

保存

更快地保存文件

使用 QFile 而非 QSaveFile 来保存文件。

启用该选项会有可忽略不计的丢失文件风险，但会显著提高保存文件的速度。

保存文件时保存测试用例

在保存代码时将测试用例一并保存。

你可以在文件路径/测试点中设置测试用例保存的位置。

自动保存

自动保存间隔类型

自动保存机制以如下的方式运作：有一个计时器，每当它被“重置”，它就会“运行” 自动保存时间间隔 毫秒，当计时器“运行”了 自动保存时间间隔 毫秒后，当前代码就会被自动保存。

After the last modification

计时器在每次修改代码后被重置。即，如果你在 自动保存时间间隔 毫秒内没有修改你的代码，则计时器完成了倒计时，同时你的代码会被自动保存。

该模式适合使用较短的 自动保存时间间隔，以使代码能在你两次输入的间歇间被自动保存。如果设置的间隔时间过长，则难以让代码被自动保存。

After the first modification

在计时器未运行时，若你修改了代码，则计时器将被重置。即，你的代码将在第一次修改后 自动保存时间间隔 毫秒被自动保存。

该模式适合使用较长的 自动保存时间间隔。如果设置的时间过短，代码会在你输入的时候被自动保存，这可能会影响你的输入体验。

Without modification

每当计时器完成倒计时，计时器会被重置。即，无论你是否修改了你的代码，你的代码都会以恒定的 自动保存时间间隔 被自动保存。

该模式适合保存测试用例。在其他模式下，如果你不修改你的代码，测试用例不会被自动保存。

终端中运行

终端程序

终端参数

本设置仅在 Linux 系统中可用。

终端程序是你想要使用的终端模拟器的名称或路径。

终端参数是终端模拟器中用于运行给定命令的参数。即，命令 <终端程序> <终端参数> <命令> 可在指定的终端模拟器中运行 <命令>。

在大多数终端模拟器，如 konsole, xterm 和 xfce-terminal，终端参数为 -e，在 gnome-terminal 中，该参数为 --。

你可以阅读你使用的终端模拟器的手册，以获取关于终端参数的相关信息。

保存会话

在启动时恢复上一次会话

在退出 CP Editor 时保存当前状态，并在启动时恢复上一次会话。

在终端下，你可以使用 --no-restore-session 命令以暂时禁用该选项。如果上一次会话过大导致 CP Editor 卡死，该命令将会解决这一问题。

定期自动保存当前会话

每隔一段时间就保存当前会话，而不是仅在退出时保存会话。

启用该选项会避免因为非正常退出（如断电，强行终止 CP Editor 等）导致代码丢失的情况发生。然而，如果代码和测试用例过大，每次自动保存时 CP Editor 会卡顿较长时间。

关联文件和题目

打开文件时加载对应题目

如果一个文件已经设置了题目链接，当该文件被再次打开时，将会使用原来的题目链接。

加载以前的题目时打开以前的文件

如果一个文件已经设置了题目链接，当使用 Competitive Companion 解析同样的题目时，将会直接打开以前的文件。

测试点

在空测试点上运行你的代码

在所有未被隐藏的测试点上运行你的代码，即使输入为空。

在输出为空的测试点上检查输出的正确性

即使程序输出或答案为空，也检查该测试点输出的正确性。

自动取消选中已通过的测试点

在运行代码后，自动将通过了的测试点取消选中。当测试点未被选中时，它们会被折叠，并且在你运行代码时不会在这些测试点上进行测试。

加载外部文件修改

若没有未保存的修改，自动加载外部文件修改

若硬盘上的文件和 CP Editor 中的文件相同，该文件在 CP Editor 外部被修改，无需确认，自动加载外部文件修改。

询问是否加载外部文件修改

若文件在 CP Editor 外部被修改，询问是否加载这些修改。

如果该选项被禁用，外部文件修改不会被加载。

若没有未保存的修改，自动加载外部文件修改会覆盖该选项的设置。即，若选项若没有未保存的修改，自动加载外部文件修改被启用，无论询问是否加载外部文件修改是否启用，外部文件修改将会在无确认的情况下被自动加载。若选项若没有未保存的修改，自动加载外部文件修改被禁用，且询问是否加载外部文件修改被启用，CP Editor 将会询问用户是否加载这些修改。而在两个选项都被禁用的情况下，外部文件修改将不会被加载。

计时器

显示计时器

在 UI 中显示计时器。你可以用它来记录做题用时。

切换标签页时启动/暂停计时器

切换标签页后，暂停原来那个标签页的计时器并启动当前标签页的计时器。

启用了这个设置，如果你在做一道题时切换到正确的标签页，你就不需要手动启动/停止计时器了。

只在按钮按下时显示计时结果

隐藏计时结果，只在“显示”按钮按下时显示。

这或许可以避免计时结果更新使人分心。

对拍

模版使用的编程语言

数据生成器模版使用的编程语言

模板路径

参见模板路径。

使用模板时光标初始位置定位使用的正则表达式

参见使用模板时的光标初始位置。

使用模板时光标初始位置的偏移类型

参见使用模板时的光标初始位置。

使用模板时光标初始位置的偏移字符量

参见使用模板时的光标初始位置。

Docs: 扩展

Mon, 01 Jan 0001 00:00:00 +0000

代码格式化

Clang Format

Clang Format 是格式化 C/C++ 和 Java 代码的工具。你可以点击动作->格式化代码或按快捷键 Ctrl+Shift+I 来格式化代码。如果你选择了代码的一部分，只有被选择的部分（以及必要的相邻部分）会被格式化。

参见安装 Clang Format 。

程序

clang-format 可执行文件的路径。如果它已经在 PATH 环境变量中，只需填写 clang-format 即可。

参数

向 clang-format 传递的参数。它不应包含 -i（就地修改选项）。

风格

Clang Format 格式化代码的风格。这里的内容和 .clang-format 的内容一致。

你可以查看 Clang-Format Style Options 或其他资料以获取关于代码格式化风格的相关信息。

YAPF

YAPF 是格式化 Python 代码的工具。你可以点击动作->格式化代码或按快捷键 Ctrl+Shift+I 来格式化代码。如果你选择了代码的一部分，只有被选择的行会被格式化。

参见安装 YAPF 。

程序

YAPF 的程序，它可以是如下两项之一：

yapf：需要能在命令行下执行 yapf 命令。参数可以为空。
Python 解释器的程序名，如 python，python2 等。参数应该为 -m yapf。

注意，你需要使用 Python 2 来格式化 Python 2 代码，使用 Python 3 来格式化 Python 3 代码。因此你需要选择正确的 Python 解释器程序。

参数

传递给 YAPF 程序的参数。如果在程序一栏里填写的是 Python 解释器，这里的参数应该是 -m yapf。参数中不应包含 -i（就地修改选项）。

风格

YAPF 格式化代码的风格，这里的内容和 .style.yapf 的内容一致。你可以运行 yapf --style-help，查看文档或其他资料以获取关于代码格式化风格的相关信息。

Language Server

参见安装 Language Server .

利用 Language Server 获取提示信息

使用 Language Server 以获取错误，警告，提示等信息。

你可以将鼠标移动到提示错误的下划线上以获取错误或警告的相关信息。

提示延迟

若距离最近一次修改的时间达到了延迟毫秒，更新提示信息。

Language Server 可执行文件路径

Language Server 可执行文件的路径。如果它已经在 PATH 环境变量中，只需填写相应的可执行文件的文件名即可。

Language Server 参数

为 Language Server 程序传递的额外参数。你可以阅读相应的 Language Server 程序的文档以了解更多信息。

例如，如果你使用 pyls 作为 Python 的 Language Server 程序，你可以填写 python 作为 Language Server 程序，-m pyls 作为参数。

Competitive Companion

参见安装 Competitive Companion .

打开新标签页

当一个问题被解析时，打开一个新标签页。

如果该选项被禁用，当一个问题被解析时，当前页面的测试用例将会被新的测试用例覆盖。

连接端口

从 Competitive Companion 接收数据使用的端口。

默认情况下该端口为 10045，在大多数情况下不用更改。在遇到端口冲突等情况时，你可以在 Competitive Companion 里设置自定义端口，并在这里更改数据接收端口。

使用从 Competitive Companion 处获取的时间限制

在解析一道题目后，为对应的标签页使用从 Competitive Companion 获取的时间限制。

头部注释

在获取一道题目后在代码开头添加的注释。

头部注释的内容

你可以在头部注释中使用如下占位符：

${time}：题目被解析的时间，相应的时间格式可以在头部注释的时间格式中设置。
${json.X.Y}：由 Competitive Companion 提供的数据的一个属性。你可以在 Competitive Companion 的文档中获得更多信息。例如，${json.name} 代表题目名。

头部注释的时间格式

${time} 占位符对应的时间的格式。你可以阅读如下 Qt 文档以获得更多信息：

CF Tool

你可以使用 CF Tool 向 Codeforces 提交你的代码。

为了提交你的代码，你需要使用 Competitive Companion 解析题目，或是手动设置标签页的题目链接。

参见安装 CF Tool .

路径

CF Tool 可执行文件的路径。如果它已经在 PATH 环境变量中，只需填写 cf 即可。

为评测结果显示气泡信息

在收到一次提交的结果后，显示一条气泡信息。

气泡信息是系统通知，在 CP Editor 外仍然可见。在你忙于解决下一个问题时，气泡信息可以让你得知前一个问题的解决情况。

WakaTime

WakaTime 可以帮助你进行工作量的统计。

参见安装 WakaTime 。

启用 WakaTime

是否启用 WakaTime。

路径

WakaTime 可执行文件的路径。如果它已经在 PATH 环境变量中，只需填写 wakatime 即可。

Api 密钥

可以在 WakaTime 设置查看。

如果有 WakaTime 的全局配置文件 ~/.wakatime.cfg 则可以留空。

使用代理

使用网络代理将数据发送给 WakaTime。

Docs: 文件路径

Mon, 01 Jan 0001 00:00:00 +0000

测试点

输入文件/答案文件保存路径

设置测试数据保存的位置。如果设置的路径是相对路径，则实际路径将基于源代码所在路径。

你可以使用如下占位符：

${filename}：完整的文件名。
${basename}：将 ${filename} 去掉扩展名后的文件名。
${0-index}：从 0 开始的测试点编号。
${1-index}：从 1 开始的测试点编号。

例如，某个输入文件是源代码 /a/b/c.cpp 的第三个测试点的输入文件，此时各占位符将会以如下方式被替换：

${filename}: c.cpp
${basename}: c
${0-index}: 2
${1-index}: 3

如果输入文件的保存路径被设定为 testcases/${basename}-${1-index}.in，则该测试数据的输入文件将会被保存在 /a/b/testcases/c-3.in 下。

测试数据匹配规则

在加载成对的测试点时，输入文件和答案文件的匹配规则。

每条规则是一对正则表达式。其中第一个正则表达式用于匹配完整输入文件名，第二个正则表达式用于匹配相应的答案文件名。

例如，你可以使用 (.+)\.in 和 \1.out 匹配 test-1.in 和 test-1.out，或者使用 (.+)\.in\.(\d+) 和 \1.ans.\2 匹配 test.in.3 和 test.ans.3。

在加载成对的测试点时，每一条与输入文件匹配的规则都会被用于尝试寻找相应的答案文件。

题目链接

针对题目链接的默认保存路径

保存一个有题目链接的新文件时，使用的默认保存路径。

每条规则是一对正则表达式。其中第一个正则表达式用于匹配题目链接的一部分，第二个正则表达式用于设置相应的保存路径。

当保存一个有题目链接的新文件时，如果题目链接与至少一个规则匹配，将使用第一个匹配的规则对应的保存路径。

下面是一个例子：

题目链接: codeforces.com/contest/([1-9]\d*)/problem/([A-Z][1-9]?)。
相应的文件路径: /home/username/Codeforces/\1/\2。

默认路径

在各种需要用户选择文件路径的情况下，默认的文件路径。对于不同的操作，可以设置不同的默认路径。

用户可以设置多种默认路径，每条默认路径都有一个名称。设置的默认路径名称可以作为占位符在其他默认路径中使用。当用户为某个操作设定新的路径，其他路径的值也可能会发生变化。

例如：

操作“保存文件”的默认路径是 ${file}，而“保存文件”会修改 file 和 testcase。
操作“加载单个测试用例”的默认路径是 ${testcase}，而“加载单个测试用例”会修改 testcase。
刚开始时，file 是 /a/b，testcase 是 /a/c。

在执行“加载单个测试用例”操作时，默认路径为 /a/c，而你操作时将路径设置为 /a/d。现在 file 代表的路径仍然是 /a/b，而 testcase 代表的路径变成了 /a/d。
在执行“保存文件”操作时，默认路径为 /a/b，而你操作时将路径设置为 /a/e。现在 file 和 testcase 代表的路径都变成了 /a/e。
在执行“加载单个测试用例”操作时，默认路径已经变成了 /a/e，因为在执行“保存文件”操作时，testcase 代表的路径被修改了。

在设置中，可以设置执行每个操作后，被改变的路径的列表，列表中相邻两项之间用逗号隔开。

Docs: 热键

Mon, 01 Jan 0001 00:00:00 +0000

你可以设置不同操作的自定义热键。你可以通过点击某个热键的编辑框，并按下你想要设置的热键，来设置某个操作的热键。你还可以按下相应热键右侧的删除按钮来清除自定义热键。

Docs: 高级

Mon, 01 Jan 0001 00:00:00 +0000

更新

启动时检查更新

在 CP Editor 启动时，检查是否有新版本的 CP Editor。

如果有新版本，则会弹出一个窗口询问你是否进行更新。

使用测试版本

检查更新时，检查 Beta 版本。 Beta 版通常具有更多功能和改进，但不如稳定版稳定。

限制

默认时间限制

执行程序的默认时间限制。

超时的程序会被终止。

输出长度限制

程序的最大输出字符数。

stdout 或 stderr 过长的程序将会被终止。

输出显示长度限制

会显示出来的程序输出的最大字符数。

如果输出过长，超长部分会被省略。

消息长度限制

主窗口右上角内每条信息的最大长度。

超长部分将会被省略。

HTML 差异查看器长度限制

HTML 差异查看器中的最大字符数。

如果输出或答案太长，差异查看器将以纯文本显示。

打开文件长度限制

允许打开的文件的最大字符数。

如果文件超长，将不会被打开。

显示测试用例长度限制

会显示出来的测试用例的最大字符数。

如果测试用例过长，超长部分会被省略，且测试用例会变得只读。

网络代理

用于检查更新的代理服务器。

Docs: 通用

Mon, 01 Jan 0001 00:00:00 +0000

临时文件夹

在 CP Editor 中，每个文件都有一个临时目录，可用于保存可执行文件等等。

你可以将其视为一个能够安全地为每个标签页（即每个文件）保存内容而不影响磁盘上其他文件的地方，并且在关闭标签页时它会被自动删除。

在 Linux 上，它位于 /tmp/cpeditor-XXXXXX。在 Windows 上，它位于 C:\Users\<username>\AppData\Local\Temp\cpeditor-XXXXXX。

正则表达式

正则表达式用于匹配字符串中的模式以及查找和替换子字符串。

你可以找到许多在线正则表达式课程，例如：正则表达式 30 分钟入门教程。

在 CP Editor 中，你可以使用 \1, \2 等用于替换模式中的第一个/第二个捕获组的内容。

CP Editor – 设置

Docs: 代码编辑

缩进宽度

光标宽度

自动缩进

文本自动换行

自动补全括号

自动删除括号

在按下 Tab 键时跳出括号

将制表符替换为空格

Docs: 语言

通用

默认编程语言

命令

C++ 命令

C++ 编译命令

C++ 可执行文件路径

C++ 运行参数

C++ 编译器输出编码

Java 命令

Java 编译命令

Java 类路径

Java 类名称

Java 运行命令

Java 运行参数

Java 编译器输出源码

Python 命令

Python 运行命令

Python 运行命令

模板

模板路径

使用模板时的光标初始位置

代码片段

管理代码片段

使用代码片段

括号

自动补全

自动删除

按 Tab 键跳出

Docs: 外观

通用

界面语言 (UI Language)

界面风格

编辑器主题

不透明度

测试用例最大高度

只显示编译并运行

在差异查看器中显示行尾字符

在代码编辑器底部添加额外的边距

字体

仅显示等宽字体

使用自定义的全局字体

Docs: 动作

保存

更快地保存文件

保存文件时保存测试用例

自动保存

自动保存间隔类型

After the last modification

After the first modification

Without modification

终端中运行

终端程序

终端参数

保存会话

在启动时恢复上一次会话

定期自动保存当前会话

关联文件和题目

打开文件时加载对应题目

加载以前的题目时打开以前的文件

测试点

在空测试点上运行你的代码

在输出为空的测试点上检查输出的正确性

自动取消选中已通过的测试点

加载外部文件修改

若没有未保存的修改，自动加载外部文件修改

询问是否加载外部文件修改

计时器

显示计时器

切换标签页时启动/暂停计时器