Sublime Text 不支持语义级重构，重命名仅基于文本匹配或轻量 AST 模拟，安全边界低于 PyCharm 或 VS Code；需手动控制范围、禁用模糊匹配、启用跨文件选项，并依赖 RenameSymbol 或 phpactor_sublime 等插件配合预览确认。

Sublime Text 本身不支持语义级重构，所谓“重命名变量”“提取函数”都是基于文本匹配或轻量 AST 的模拟操作，安全边界远低于 PyCharm 或 VS Code。直接依赖插件一键重构，大概率改错字符串、注释或跨作用域变量。

用 RenameSymbol 做变量重命名：必须手动控制范围

RenameSymbol 是目前 Sublime 上最靠谱的重命名插件，但它不是 IDE 级别工具——它靠解析语法树（AST 或 tree-sitter）识别标识符，但默认只在当前文件生效，且极易误匹配。

• 安装后必须手动开启跨文件重命名："rename_across_files": true，否则 Ctrl+Shift+R 只改当前文件
• 务必禁用模糊匹配："fuzzy_match": false，否则 user 可能误替 username 中的子串
• 重命名前先按 Ctrl+Shift+R 看预览列表：如果出现 "user_id"（字符串）、# user_id is required（注释）或函数外层同名 err，就别点确认
• PHP/Python/JS 文件需设置正确 syntax：比如 Vue 文件里嵌 JS，得用 JavaScript (Babel) 而非原生 JavaScript，否则 async 函数体内的变量不被识别
• Python 中 self.xxx 默认不参与重命名，要加配置 "include_self_attributes": true

提取函数或模块：没有一键功能，靠组合操作

Sublime 没有“Extract Method”菜单项，也没有作用域感知的代码块提取能力。所谓“提取”，本质是人工剪切 + 手动封装 + 路径创建。

Linear CLI

一款AI工具，主要用于使用 linear-cli 代理原生运行时从 Claude Code、Codex 或其他代理读取和变更 Linear。适用于需要默认 JSON 输出的场景，适合需要提升相关任务效率的用户。

下载

• 选中逻辑块 → Ctrl+C 复制 → Ctrl+Alt+N（AdvancedNewFile）输入路径新建文件，例如 lib/utils.py
• 在新文件中粘贴代码，并手动补全 def 声明、参数、返回值；不要指望自动推导签名
• 回到原文件，在调用位置写 from lib.utils import new_func 或 import lib.utils，再替换原逻辑为函数调用
• 对 PHP 项目，PHP Companion 可生成 getter/setter 或构造函数模板，但不支持从任意代码段自动生成函数
• 别用多光标盲目替换：比如把所有 mysql_query 改成 mysqli_query，得先 Ctrl+Shift+F 搜索 \$[a-zA-Z_]\w*\s*=\s*mysql_query\([^)]*\) 确认上下文

PHP 项目重构：phpactor_sublime 是唯一接近语义的选项

相比 RenameSymbol，phpactor_sublime 依赖本地 phpactor 服务，能识别类、接口、方法签名和依赖注入关系，适合现代 PHP 项目迁移。

• 必须全局安装 phpactor：composer global require phpactor/phpactor --prefer-dist，并确保 bin 目录在 PATH 中
• 插件配置里必须指定 phpactor_bin 绝对路径，Windows 用户注意用 .bat 后缀，例如 C:\Users\YourName\AppData\Roaming\Composer\vendor\bin\phpactor.bat
• 项目根目录必须有 composer.json，否则 phpactor status 报错，插件功能全部失效
• 快捷键 Alt+R+R 重命名时，它会尝试过滤掉字符串和注释，但仍可能误改 __call() 动态调用中的魔术方法名
• 若 Alt+G（跳转到定义）无响应，先终端执行 phpactor --version，再检查 Sublime 控制台是否有 phpactor 启动失败日志

别踩这些坑：配置和习惯比插件更重要

很多“重构失败”不是插件问题，而是编辑器状态没对齐。比如 syntax 错了、项目根没设、PATH 没生效，或者你根本没意识到 Sublime 不解析运行时行为。

• 所有重构操作前，先按 Ctrl+Shift+P → Set Syntax 确认当前文件类型，尤其对 .vue、.jinja、.blade.php 这类混合文件
• 全局搜索替换一定要加文件过滤：Ctrl+Shift+F → 在 Where 栏填 *.py 或 src/**/*.js，避免误改 node_modules 或 dist
• 修改前用 Ctrl+Z 配合 Ctrl+Shift+P → Revert 快速回退，别等 Git diff 发现改错了才慌
• PHP 项目用 SublimeLinter + phplint 实时标出未定义变量，比重构后跑测试更早发现问题
• 别信“一键重构”宣传——RenameSymbol 和 phpactor_sublime 都需要你肉眼核对预览列表，这是不可跳过的步骤