⚡

Rust重构助手Skill rust-refactor-helper

Rust重构助手是一款基于LSP（语言服务器协议）的代码重构工具，专门用于Rust语言的安全重构操作。支持重命名符号、提取函数、内联函数、移动模块等核心功能，通过全面的影响分析和安全检查，确保重构过程的安全性和准确性。提供预览模式(--dry-run)让开发者在应用更改前查看所有变更，避免意外错误。关键词：Rust重构、LSP分析、安全重构、代码优化、重命名、提取函数、移动模块、影响分析、代码维护、开发工具

后端开发 0 次安装 0 次浏览 更新于 2/27/2026

name: rust-refactor-helper description: “使用LSP分析进行安全的Rust重构。触发词：/refactor, rename symbol, move function, extract, 重构, 重命名, 提取函数, 安全重构” argument-hint: “<操作> <目标> [–dry-run]” allowed-tools: [“LSP”, “Read”, “Glob”, “Grep”, “Edit”]

Rust 重构助手

通过全面的影响分析执行安全的重构操作。

使用方法

/rust-refactor-helper <操作> <目标> [--dry-run]

操作类型:

  • rename <旧名称> <新名称> - 重命名符号
  • extract-fn <选择范围> - 提取为函数
  • inline <函数名> - 内联函数
  • move <符号> <目标路径> - 移动到模块

示例:

  • /rust-refactor-helper rename parse_config load_config
  • /rust-refactor-helper extract-fn src/main.rs:20-35
  • /rust-refactor-helper move UserService src/services/

使用的LSP操作

重构前分析

# 重命名前查找所有引用
LSP(
  operation: "findReferences",
  filePath: "src/lib.rs",
  line: 25,
  character: 8
)

# 获取符号信息
LSP(
  operation: "hover",
  filePath: "src/lib.rs",
  line: 25,
  character: 8
)

# 移动操作时检查调用层次
LSP(
  operation: "incomingCalls",
  filePath: "src/lib.rs",
  line: 25,
  character: 8
)

重构工作流

1. 重命名符号

用户: "将parse_config重命名为load_config"
    │
    ▼
[1] 查找符号定义
    LSP(goToDefinition)
    │
    ▼
[2] 查找所有引用
    LSP(findReferences)
    │
    ▼
[3] 按文件分类
    │
    ▼
[4] 检查冲突
    - 'load_config'是否已被使用？
    - 是否有宏生成的引用？
    │
    ▼
[5] 显示影响分析（--dry-run模式）
    │
    ▼
[6] 使用Edit工具应用更改

输出:

## 重命名: parse_config → load_config

### 影响分析

**定义位置:** src/config.rs:25
**找到的引用:** 8个

| 文件 | 行号 | 上下文 | 更改类型 |
|------|------|---------|--------|
| src/config.rs | 25 | `pub fn parse_config(` | 定义 |
| src/config.rs | 45 | `parse_config(path)?` | 调用 |
| src/main.rs | 12 | `config::parse_config` | 导入 |
| src/main.rs | 30 | `let cfg = parse_config(` | 调用 |
| src/lib.rs | 8 | `pub use config::parse_config` | 重新导出 |
| tests/config_test.rs | 15 | `parse_config("test.toml")` | 测试 |
| tests/config_test.rs | 25 | `parse_config("")` | 测试 |
| docs/api.md | 42 | `parse_config` | 文档 |

### 潜在问题

⚠️ **文档引用:** docs/api.md:42 可能需要手动更新
⚠️ **重新导出:** src/lib.rs:8 - 公共API变更

### 是否继续？
- [x] --dry-run (仅预览)
- [ ] 应用更改

2. 提取函数

用户: "将main.rs中20-35行提取为函数"
    │
    ▼
[1] 读取选中的代码块
    │
    ▼
[2] 分析变量
    - 哪些是输入？（在块中使用但未定义）
    - 哪些是输出？（在块中定义并在之后使用）
    - 哪些是局部变量？（在块中定义且仅在块中使用）
    │
    ▼
[3] 确定函数签名
    │
    ▼
[4] 检查提前返回、循环等
    │
    ▼
[5] 生成提取的函数
    │
    ▼
[6] 用函数调用替换原始代码

输出:

## 提取函数: src/main.rs:20-35

### 选中的代码
​```rust
let file = File::open(&path)?;
let mut contents = String::new();
file.read_to_string(&mut contents)?;
let config: Config = toml::from_str(&contents)?;
validate_config(&config)?;
​```

### 分析

**输入:** path: &Path
**输出:** config: Config
**副作用:** 文件I/O，可能返回错误

### 提取的函数

​```rust
fn load_and_validate_config(path: &Path) -> Result<Config> {
    let file = File::open(path)?;
    let mut contents = String::new();
    file.read_to_string(&mut contents)?;
    let config: Config = toml::from_str(&contents)?;
    validate_config(&config)?;
    Ok(config)
}
​```

### 替换代码

​```rust
let config = load_and_validate_config(&path)?;
​```

3. 移动符号

用户: "将UserService移动到src/services/"
    │
    ▼
[1] 查找符号及其所有依赖
    │
    ▼
[2] 查找所有引用（调用者）
    LSP(findReferences)
    │
    ▼
[3] 分析所需的导入变更
    │
    ▼
[4] 检查循环依赖
    │
    ▼
[5] 生成移动计划

输出:

## 移动: UserService → src/services/user.rs

### 当前位置
src/handlers/auth.rs:50-120

### 依赖项（将一起移动）
- struct UserService (50-80)
- impl UserService (82-120)
- const DEFAULT_TIMEOUT (48)

### 所需的导入变更

| 文件 | 当前导入 | 新导入 |
|------|---------|-----|
| src/main.rs | `use handlers::auth::UserService` | `use services::user::UserService` |
| src/handlers/api.rs | `use super::auth::UserService` | `use crate::services::user::UserService` |
| tests/auth_test.rs | `use crate::handlers::auth::UserService` | `use crate::services::user::UserService` |

### 新文件结构

​```
src/
├── services/
│   ├── mod.rs (新建 - 添加 `pub mod user;`)
│   └── user.rs (新建 - UserService移动至此)
├── handlers/
│   └── auth.rs (UserService已移除)
​```

### 循环依赖检查
✅ 未检测到循环依赖

安全检查

检查项 目的
引用完整性 确保找到所有使用处
名称冲突 检测已存在的同名符号
可见性变更 警告pub/private作用域变更
宏生成代码 警告宏中的代码
文档 标记提及符号的文档注释
测试覆盖 显示受影响的测试

预览模式

始终先使用--dry-run预览更改：

/rust-refactor-helper rename old_name new_name --dry-run

这将显示所有更改而不实际应用。

相关技能

场景 查看
导航到符号 rust-code-navigator
理解调用流程 rust-call-graph
项目结构 rust-symbol-analyzer
Trait实现 rust-trait-explorer