Cursor Fake Machine 核心指南

一、核心功能解析

作为开发者，我们最关心工具的实际能力。Cursor Fake Machine 本质是一个 VS Code 扩展开发框架，通过「激活函数」衔接编辑器与业务逻辑，就像给 VS Code 装上可编程的"机械臂"。

核心文件速览

项目的灵魂藏在这5个文件中：

• extension.js：扩展主入口，控制生命周期
• package.json：项目身份证，声明依赖和入口点
• eslint.config.mjs：代码质检员，确保风格统一
• pnpm-lock.yaml：依赖快照，冻结版本防止"薛定谔的依赖"
• icon.png：扩展头像，在 VS Code 市场展示的身份标识

[!TIP] 💡 所有配置文件应纳入版本控制，避免"在我电脑上能运行"的尴尬局面

二、极简上手流程

从0到1启动项目只需3步，比泡杯咖啡还快。

3步启动流程

1. 克隆代码库

   git clone https://gitcode.com/gh_mirrors/cu/cursor-fake-machine
   

2. 安装依赖

   cd cursor-fake-machine && pnpm install
   

3. 启动开发环境
   按 F5 启动扩展开发宿主窗口，VS Code 会自动加载当前项目

[!TIP] 💡 推荐使用 VS Code 开发，内置扩展调试工具可实时预览效果

三、配置文件深度解析

配置文件是项目的"隐形指挥中心"，理解它们才能真正掌控项目。

配置文件智能修改

• package.json：像给项目填简历，name/version/engines 字段决定扩展在市场的展示和兼容性
• .npmrc：项目专属的 npm 遥控器，通过 registry 字段切换镜像源解决下载慢问题
• eslint.config.mjs：代码风格的裁判，rules 字段定义"什么代码算优雅"

// extension.js 核心逻辑
function activate(context) {
    // 核心逻辑：注册命令监听
    let disposable = vscode.commands.registerCommand('cursor-fake-machine.helloWorld', () => {
        vscode.window.showInformationMessage('Hello from Cursor Fake Machine!');
    });
    context.subscriptions.push(disposable);
}
exports.activate = activate;

[!TIP] 💡 修改配置后建议重启开发窗口，确保新配置生效

四、常见问题速查

开发中总会遇到"卡壳"时刻，这三个解决方案能解决80%的问题。

问题解决手册

1. 依赖冲突？
   → 删 node_modules 后用 pnpm install 重新安装，pnpm-lock.yaml 会确保版本一致

2. ESLint 报错？
   → 运行 npx eslint --fix 自动修复多数格式问题，复杂问题需手动调整规则

3. 扩展不激活？
   → 检查 package.json 中 activationEvents 配置，确保包含正确的触发事件

[!TIP] 💡 遇到诡异问题时，尝试清除 VS Code 扩展缓存：rm -rf ~/.vscode/extensions/cursor-fake-machine*