GriddyCode：模块化代码编辑工具指南

探索核心功能

GriddyCode 是一款注重可扩展性的代码编辑工具，其模块化设计允许用户通过插件系统和配置文件定制编辑器行为。核心功能包括多语言语法高亮、主题切换、文件管理和实时预览，所有功能均通过 Lua 脚本系统实现灵活配置。

快速上手操作

安装项目文件

🔧 克隆项目仓库到本地：

git clone https://gitcode.com/GitHub_Trending/gr/griddycode
cd griddycode

启动编辑器

🔧 通过命令行启动应用：

# 直接启动编辑器
./cli/gcode

# 启动并打开指定文件
./cli/gcode path/to/your/file.py

⚠️ 注意：首次使用需确保系统已安装 Lua 运行环境和项目依赖。

深度定制指南

配置语法高亮规则

如何自定义 Python 语法高亮？→ 通过编辑 Lua/Plugins/py.lua 文件实现。该文件采用模块化设计，每个语言插件独立维护语法规则。

示例配置（Lua/Plugins/py.lua）：

-- 为Python关键字添加特殊高亮
highlight("def", { color = "#5E81AC", bold = true })
highlight("class", { color = "#88C0D0", italic = true })

-- 自定义字符串高亮样式
highlight("string", { color = "#A3BE8C", underline = false })

创建自定义主题

当你需要改变编辑器外观时，应关注 Lua/Themes 目录下的主题文件。每个主题作为独立模块存在，便于切换和分享。

示例主题（Lua/Themes/MyCustomTheme.lua）：

local theme = {
    background = "#1E1E2E",      -- 编辑器背景色
    foreground = "#CDD6F4",      -- 默认文本颜色
    comment = "#6C7086",         -- 注释颜色
    keyword = "#BB9AF7",         -- 关键字颜色
    string = "#94E2D5",          -- 字符串颜色
    function_name = "#89B4FA"    -- 函数名颜色
}
return theme

⚠️ 主题创建后需在 settings.gd 中启用才能生效。

常见问题解答

Q1: 如何添加新的编程语言支持？

A1: 只需在 Lua/Plugins 目录下创建对应语言的 Lua 文件（如 ruby.lua），实现语法解析和高亮规则，系统会自动加载新语言支持。

Q2: 主题切换后没有立即生效怎么办？

A2: 主题更改需要重启编辑器才能完全应用。你也可以通过快捷键 Ctrl+Shift+R 强制刷新主题配置。

Q3: 如何备份自定义配置？

A3: 所有用户配置文件集中在 Lua/Themes 和 Lua/Plugins 目录，建议定期备份这两个目录以保存个性化设置。

扩展功能探索

GriddyCode 的模块化架构支持通过插件扩展功能。社区贡献的插件位于 addons 目录，包括代码格式化、版本控制集成等工具。通过编辑 plugins.cfg 文件可以启用或禁用特定插件，实现编辑器功能的按需定制。