code

code 在浏览器编辑器中打开可写源码文件,根据文件名识别语法,并可用 -n 明确创建缺失文件。语法高亮是可选增强;没有高级编辑器资源时仍可进行普通文本编辑。

开发版本 1.3.6稳定
lil-terminal

概览

当语法上下文很重要时,code 可以直接编辑源码而不会执行它。常见文件由自动识别处理;生成文件或非常规扩展名可以显式指定语言。

直接在浏览器中编辑源码

code sandbox/src/Calculator.php 会直接打开该文件进行编辑。只有确实要新建文件时才使用 -n;文件名无法说明语言时使用 -l <lang>。普通文本则更适合 edit

语法

lil-terminal
code <file> [-n] [-l <lang>|-<lang>]

参考

code <file>

在代码编辑器中打开文件

-n

打开前创建缺失文件

-l <lang> | -<lang>

选择 php、html、xml、css、js、json、ini、md、py、sql、sh 或 lil 高亮

include -code -i @include

查看自动管理的编辑器界面包

include -code -u @include

保留 code 命令并删除可选编辑器资源

help hotkeys

显示编辑器快捷键

选择编辑器

当语法结构有助于检查源码时使用 code <file>。普通文本的快速修改可使用更轻量的 edit <file>。在编辑器中打开文件不会执行其中内容。

语言识别

语言来自文件名与扩展名。.env 使用 INI 高亮,未知格式以纯文本打开。生成文件或非常规扩展名可通过 -l <lang> 指定语言。

文件规则

只允许普通、可读、可写的文本文件。二进制文件会被拒绝。上限为 2 MiB 和 100000 行。使用 -n 时,父目录必须已经存在且可写。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示;服务器不会执行任何终端命令。

在代码编辑器中打开文件

安装与管理

安装当前兼容版本。完整功能请选择 Base,精简包请选择 Minimum;已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install code
Minimum 包

安装精简包。该包不包含本地参考;help <cmd> -i 会打开当前服务器参考。

install code -m
精确公开版本

安装这个确切的已发布版本。

install code -v 1.3.6
检查或升级

让 upgrade 检查兼容性,仅在需要时替换已安装块。

upgrade code
删除模块

删除扩展块,不影响核心和其他模块。

install code -u

示例

示例可复制,但网站不会执行。请先检查路径、权限和破坏性选项。

在代码编辑器中打开文件
cd \sandbox | code src/Calculator.php
File      sandbox/src/Calculator.php
Language  php
Editor    opened
打开前创建缺失文件
code \sandbox\tmp\review.js -n
File      sandbox/tmp/review.js
Language  js
New       yes
Editor    opened
选择 php、html、xml、css、js、json、ini、md、py、sql、sh 或 lil 高亮
code \sandbox\config\app.json -json
File      sandbox/config/app.json
Language  json
Mode      forced
Editor    opened
选择 php、html、xml、css、js、json、ini、md、py、sql、sh 或 lil 高亮
code \sandbox\scripts\demo.lil -l lil
File      sandbox/scripts/demo.lil
Language  lil
Mode      explicit
Editor    opened
查看自动管理的编辑器界面包
include -code -i
Package     code
Version     1.0
Components  css + js
Installed   yes

这些命令安装可选的编辑器资源。即使没有这些资源,code 也会安全地退回到内置基础编辑器。

处理缺失的源码文件
code \sandbox\missing.php
未找到文件

本示例使用的文件: sandbox/src/Calculator.php

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

<?php

declare(strict_types=1);

final class Calculator
{
    public static function add(int $left, int $right): int
    {
        return $left + $right;
    }
}

相关文档

当前公开版本

v1.3.62026-08-10

语言同步

完成 code 的本地帮助与服务器帮助同步,并加强本地化安全性。