LeetCodeTools for Sublime Text

LeetCodeTools is A Sublime Text plugin for practicing LeetCode without leaving your editor. It lets you search problems, fetch problems and official solutions, run your code offline against the official examples, submit directly to LeetCode, and pick problems from study plans like Hot 100 and Top Interview 150. Problems and solutions are saved locally as Markdown files; log in once and you're good to go.

LeetCodeTools 是一个 Sublime Text 插件，让你不用离开编辑器就能刷力扣（LeetCode）。它支持按题号或关键字搜索题目、拉取题目和官方题解、在本地离线运行代码并与官方示例对比、一键提交到力扣判题，还能从「热题 100」「面试经典 150 题」等题集里选题。题目和题解都会以 Markdown 文件保存到本地，登录一次即可长期使用。 一个让你不用离开编辑器、直接在 Sublime Text 里刷力扣（LeetCode.cn）的插件：搜索题目、拉取题目与官方题解、离线运行、直接提交。

Features / 功能

Installation / 安装

1. Install Package Control first if you don't have it yet. 先安装 Package Control（如果还没有）。

2. Press Ctrl+Shift+P (Cmd+Shift+P on macOS), run Package Control: Install Package, search for LeetCodeTools, and press Enter to install. 按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），运行 Package Control: Install Package，搜索 LeetCodeTools 并回车安装。

3. Install a system Python 3 and add it to PATH. It is required by the offline Run (not by Login). 安装一个系统 Python 3 并加入 PATH。离线 Run 需要它（登录不需要）。

4. Press Ctrl+Shift+P, run LeetCode Tools: Login; it opens leetcode.cn in your browser. Log in, then copy the LEETCODE_SESSION cookie (F12 → Application → Cookies → LEETCODE_SESSION; double-click its Value and press Ctrl+A to select it all) and paste it into the input panel. 按 Ctrl+Shift+P，运行 LeetCode Tools: Login；它会在浏览器打开 leetcode.cn，登录后复制 LEETCODE_SESSION cookie（F12 → Application → Cookies → LEETCODE_SESSION，双击 Value 后 Ctrl+A 全选）粘贴到输入框即可。

Note: Search / Fetch / Update / Submit need the login cookie; Open in Browser, Run, and Fetch Official Explanations do not (the official solution uses the public GraphQL API). 说明：Search / Fetch / Update / Submit 需要登录 Cookie；Open in Browser、Run、Fetch Official Explanations 不需要登录（其中官方题解走的是公开 GraphQL 接口）。

Configuration / 配置

Settings are edited via Preferences: LeetCodeTools Settings in the command palette, or Preferences → Package Settings → LeetCodeTools → Settings in the menu: 设置通过命令面板的 Preferences: LeetCodeTools Settings，或菜单 Preferences → Package Settings → LeetCodeTools → Settings 编辑：

Supported languages / 支持的语言

These languages can be used with Fetch (code template) and Submit; the offline Run is Python-only (see limitations below). 以下语言可用于 Fetch（代码模板）和 Submit；离线 Run 目前仅支持 Python（见下方限制）。

Usage / 使用流程

1. Log in (once): LeetCode Tools: Login → log in in the browser → copy LEETCODE_SESSION → paste it. 登录（只需一次）：LeetCode Tools: Login → 浏览器登录 → 复制 LEETCODE_SESSION → 粘贴。

2. Fetch a problem: LeetCode Tools: Fetch → enter an id (e.g. 1 or 1 python3); it opens the .md and code file. 拉题：LeetCode Tools: Fetch → 输入题号（如 1 或 1 python3），自动打开 .md 和代码文件。

3. Solve it: write your solution in the code file. 做题：在代码文件里写解法。

4. Run locally: LeetCode Tools: Run shows a comparison with the official examples in the output panel. 本地跑：LeetCode Tools: Run，在输出面板看到和官方示例的对比结果。

5. Submit: LeetCode Tools: Submit; failed cases are appended to the local _in.json / _out.json for offline replay. 提交：LeetCode Tools: Submit，失败用例会自动追加到本地 _in.json / _out.json，方便离线复现。

6. Read the solution: LeetCode Tools: Fetch Official Explanations generates and opens xxx_explanation.md. 看题解：LeetCode Tools: Fetch Official Explanations，生成并打开 xxx_explanation.md。

Generated files / 生成的文件

User-facing files go under working_dir; the plugin's internal files go into the cache. 用户可见的文件存在 working_dir，插件内部文件存在缓存目录。

Under working_dir（在 working_dir 下）:

In the cache {working_dir}/.cache/（在缓存目录下）:

Current limitations / 当前限制

• Offline Run currently supports only Python: the local judge runs your code with Python exec and includes built-in parsing for ListNode / TreeNode / Node. Other languages (java / cpp / javascript / golang, …) can only Fetch templates and Submit — not run locally.
• 离线 Run 目前仅支持 Python：本地判题用 Python exec 运行你的代码，并内置了 ListNode / TreeNode / Node 的用例解析。其它语言（java / cpp / javascript / golang 等）目前只能 Fetch 代码模板和 Submit 提交，不能本地 Run。
• Only the China site (leetcode.cn) is supported; the global site (leetcode.com) is planned but not yet implemented.
• 目前只支持中国版（leetcode.cn）；美国版/国际版（leetcode.com）待实现。

Roadmap / 待办

• Separate the parser (test-case parsing + linked-list/tree/graph building + offline judge) out of leetcodetools.py into a standalone module/script, so it can run from the command line outside Sublime (e.g. python -m leetcodetools_offline solution.py). 把 parser（用例解析 + 链表/树/图构建 + 离线判题）从 leetcodetools.py 里分离成独立模块 / 脚本，使其可以脱离 Sublime、在命令行本地执行（例如 python -m leetcodetools_offline solution.py）。
• Class / design problems (e.g. Min Stack, where you implement a class with multiple methods) are not supported by the offline Run yet. 「最小栈」这类 class 设计题（需要实现一个类、多个方法）暂不支持本地 Run。

Directory structure / 目录结构

LeetCodeTools/
├── leetcodetools.py                # Main plugin (commands + GraphQL client + offline judge). 主插件（命令 + GraphQL 客户端 + 离线判题）
├── Default.sublime-commands        # Command-palette menu. 命令面板菜单
├── LeetCodeTools.sublime-settings  # Default settings. 默认配置
└── .python-version                 # Dev Python version. 开发环境 Python 版本

Notes / 其它

• The login cookie is cached at {working_dir}/.cache/cookie.json; the problem list at {working_dir}/.cache/problem_list.json; study plans at {working_dir}/.cache/study_plans.json and {working_dir}/.cache/study_plan_problems.json. 登录 Cookie 缓存在 {working_dir}/.cache/cookie.json，题目列表缓存在 {working_dir}/.cache/problem_list.json，题集缓存在 {working_dir}/.cache/study_plans.json 和 {working_dir}/.cache/study_plan_problems.json。
• When you pick a problem from a study plan (Select from Problem Set), submitting it also marks it as done in that study plan. 从题集（Select from Problem Set）选的题，提交时也会在对应题集里标记完成。