{
  "schemaVersion": 1,
  "citationId": "ecn:v4/getting-started/running-effects@16b1646#runsync",
  "citeUrl": "/cite/377ab07b8d1f9e2f.json",
  "digest": "377ab07b8d1f9e2f",
  "slug": "v4/getting-started/running-effects",
  "version": "v4",
  "title": "运行 Effect",
  "anchor": "runsync",
  "headingPath": [
    "runSync"
  ],
  "pageUrl": "/docs/v4/getting-started/running-effects/",
  "deepLink": "/docs/v4/getting-started/running-effects/#runsync",
  "officialUrl": "https://effect.website/docs/v4/getting-started/running-effects",
  "upstreamPath": "v4/getting-started/running-effects.mdx",
  "upstreamCommit": "16b1646850ded8b32b8b86bbdd941092d55d8f24",
  "upstreamRawUrl": "https://raw.githubusercontent.com/Effect-TS/website/16b1646850ded8b32b8b86bbdd941092d55d8f24/apps/web/src/content/docs/v4/getting-started/running-effects.mdx",
  "status": "published",
  "stale": false,
  "contentHash": "1f83008e5dae2091",
  "chunkText": "同步执行一个 effect，立即运行并返回其结果。\n\n示例（同步日志输出）\n\nconst program = Effect.sync(() => {\n console.log(\"Hello, World!\")\n return 1\n})\n\nconst result = Effect.runSync(program)\n// Output: Hello, World!\n\nconsole.log(result)\n\nresult // => 1\n\n使用 Effect.runSync 来运行不会失败、也不包含任何异步操作的 effect。如果该\n\neffect 会失败或涉及异步操作，它会抛出错误，执行会在失败或异步操作发生的位置\n\n停止。\n\n示例（在会失败或异步的 effect 上错误地使用）\n\ntry {\n // Attempt to run an effect that fails\n Effect.runSync(Effect.fail(\"my error\"))\n} catch (e) {\n console.error(e)\n}\n/\nOutput:\nmy error\n/\n\ntry {\n // Attempt to run an effect that involves async work\n Effect.runSync(Effect.promise(() => Promise.resolve(1)))\n} catch (e) {\n console.error(e)\n}\n/\nOutput:\n{\n message: 'An asynchronous Effect was executed with Effect.runSync',\n fiber: FiberImpl { ... },\n tag: 'AsyncFiberError',\n 'effect/Cause/AsyncFibe …",
  "generatedAt": "2026-09-18T14:48:33.525Z"
}