跳到主要内容

使用 VSCode 开发脚本

ScriptCat 提供了 VSCode 扩展，让你可以在 VSCode 中编写用户脚本，保存后自动同步到浏览器中的 ScriptCat，无需手动复制粘贴，大幅提升开发效率。

安装准备​

你需要安装以下两个工具：

  1. 浏览器安装 ScriptCat 扩展 — 如果还没有安装，请参考 快速开始 进行安装
  2. VSCode 安装 ScriptCat 扩展 — 在 VSCode 扩展商店搜索「ScriptCat」，或前往 GitHub 仓库 下载安装

建立连接​

安装完成后，需要让浏览器中的 ScriptCat 与 VSCode 建立连接：

  1. 点击浏览器中的 ScriptCat 图标，打开管理面板
  2. 进入 工具 > 开发调试
  3. 找到 自动连接 VSCode 服务，启用并点击 连接

连接成功后，VSCode 和 ScriptCat 之间就建立了实时通道。

同步脚本​

连接建立后，你可以选择两种方式来同步脚本：

方式一：自动识别模式（推荐）​

  1. 在 VSCode 中按 Ctrl + Shift + P（Mac 为 Cmd + Shift + P）打开命令面板
  2. 输入并选择 scriptcat.autoTarget
  3. 之后每次打开或保存 .user.js 文件，都会自动同步到 ScriptCat

方式二：指定脚本模式​

  1. 在 VSCode 中按 Ctrl + Shift + P（Mac 为 Cmd + Shift + P）打开命令面板
  2. 输入并选择 scriptcat.target
  3. 指定要同步的脚本文件路径

开发流程​

设置完成后，开发流程非常简单：

  1. 在 VSCode 中编写或修改 .user.js 脚本
  2. 按 Ctrl + S 保存文件
  3. 脚本自动同步到浏览器中的 ScriptCat
  4. 切换到浏览器刷新页面即可看到效果

整个过程无需手动操作，保存即生效。

常见问题​

无法连接怎么办？​

  • 确认浏览器中的 ScriptCat 扩展已启动
  • 确认 VSCode 中的 ScriptCat 扩展已安装并启用
  • 检查 ScriptCat 管理面板中「开发调试」页面的连接状态

保存后脚本没有更新？​

  • 确认文件名以 .user.js 结尾
  • 确认已执行过 scriptcat.autoTarget 或 scriptcat.target 命令
  • 检查 VSCode 输出面板中是否有错误信息

VSCode 重启后需要重新连接吗？​

如果启用了「自动连接 VSCode 服务」，VSCode 重启后会自动重新连接，无需手动操作。