YouTube 嵌入代码生成器
简介
Toollect 的 YouTube 嵌入代码生成器可一键将任意 YouTube 视频 URL 或单个视频 ID 转换为可复制 iframe 代码。粘贴链接、选择播放器行为、生成、预览、复制、粘贴，整个过程只需几秒钟，每个选项都对应一个今天仍然有效的真实 YouTube 参数。
它解决的是繁琐的问题。官方分享对话框只能给出一个固定 iframe，无法控制大小、比例或行为，而每个「如何嵌入 YouTube」的教程都会把你引向一串需要手动写进 URL 的参数。这个工具替你完成组装：选择宽高比，另一侧尺寸自动计算；开启无 Cookie 模式、循环、控件；无需打开任何编辑器即可将视频截取到指定的开始和结束时间。
生成器刻意是一款单视频工具。它接受真实 YouTube 链接的完整语法，包括 watch URL、youtu.be 短链接、Shorts、直播，甚至单个视频 ID，并将它们全部规范化为一个标准的嵌入 URL。一切都在你的浏览器中完成，无需 API 密钥、无需账户，你的链接相关信息不会离开你的设备。唯一的网络请求是诚实的那一个：实时预览会加载真实的播放器 iframe，让你在复制之前验证结果。
使用场景
YouTube 视频嵌入出现的地方远不止博客文章，而且每个场景中选项的意义各不相同。
- 博客和文章页面。 560×315 的 16:9 预设符合大多数 CMS 主题的预期，无 Cookie 域名默认保持嵌入符合 GDPR 要求。
- 课程和文档页面。 start 和 end 可以向学生展示长篇讲座的精确片段，生成的代码可在任何接受原始 HTML 的学习平台上运行。
- Shorts 和竖屏内容。 9:16 预设为竖屏视频生成 360×640 的手机形播放器，这是大多数其他生成器根本没有的。
- 自助终端和标牌屏幕。 关闭播放器控件可获得干净、无干扰的播放界面，必要时用循环开关进行连续播放。
- 设计原型。 自定义比例模式接受 144 到 3840 像素之间的任意宽度和高度，你可以将视频以精确像素尺寸放入 Figma 或 HTML 原型中。
- 注重隐私的网站。 这里默认使用无 Cookie 域名，而官方对话框总是生成 www.youtube.com 的 URL，除非你知道需要手动修改。
工作原理
生成器是一个两阶段流水线，两个阶段都完全在你的浏览器中运行。
第一阶段：ID 提取。 URL 解析器识别所有常见的 YouTube 链接形式并提取 11 位字符的视频 ID。YouTube 嵌入播放器只需要这个 ID。单个 ID 也被接受，因此你可以粘贴从地址栏或数据库复制的 ID。
第二阶段：代码组装。 ID 被插入嵌入 URL 模板，每个启用的选项都会追加一个查询参数：
https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ?autoplay=1&start=30
iframe 标签带有明确的宽度和高度属性、无障碍标题、标准 allow 权限列表和 allowfullscreen。YouTube 的一个特性会被自动处理：循环播放的单个视频必须以单条目播放列表的形式呈现，因此循环开关会将 loop=1 和 playlist=VIDEO_ID 一起添加。没有第二个参数，YouTube 会静默忽略循环。
预览就是生成的代码所包含的同一个 iframe，该工具渲染真实的播放器而非仿制品。你在预览中看到的内容正是你的访客将看到的内容，包括 YouTube 自身如何提示已删除、私密或不可用的视频。
支持的 URL 格式
解析器接受所有能标识单个视频的形式，拒绝所有不能的形式。
可接受
| URL 格式 | 示例 |
|---|---|
| watch URL | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
| 短链接 | https://youtu.be/dQw4w9WgXcQ |
| embed URL | https://www.youtube.com/embed/dQw4w9WgXcQ |
| Shorts URL | https://www.youtube.com/shorts/dQw4w9WgXcQ |
| live URL | https://www.youtube.com/live/dQw4w9WgXcQ |
| /v/ URL | https://www.youtube.com/v/dQw4w9WgXcQ |
| 无 Cookie 域名 | https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ |
| 单个视频 ID | dQw4w9WgXcQ |
带有 &t=42s 或 &list=PL... 等附加查询参数的 watch URL 也能被正确解析，生成器会提取 ID 并忽略其余部分，因为嵌入参数是从你的设置重新构建的，而不是从链接中复制。
会被拒绝
| URL 格式 | 拒绝原因 |
|---|---|
| 播放列表链接 | youtube.com/playlist?list=PL... 标识的是播放列表，不是单个视频 |
| 频道页面 | youtube.com/@channel 没有视频 ID |
| 搜索 URL | youtube.com/results?search_query=... 没有视频 ID |
| 用户页面 | youtube.com/user/name 没有视频 ID |
| 无 ID 的 Shorts | youtube.com/shorts/ 是索引页面，不是视频 |
嵌入代码的结构
生成的 iframe 很紧凑，每个部分都有其职责。以下是 16:9 的标准输出：
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
| 属性 | 作用 |
|---|---|
| width / height | 播放器尺寸（像素）。更改宽度时会根据所选宽高比重新计算高度，反之亦然。 |
| src | 嵌入 URL。默认主机是 www.youtube-nocookie.com，关闭无 Cookie 模式会切换为 www.youtube.com。查询参数承载播放器选项。 |
| title | 屏幕阅读器为框架播报的无障碍名称。它保留 YouTube 的官方默认值，使生成的代码与 YouTube 自身发布的内容一致。 |
| frameborder | 用于兼容旧版 HTML 校验器的遗留属性，在现代浏览器中没有视觉效果。 |
| allow | 嵌入播放器的权限策略，支持全屏和自动播放，与官方 YouTube 嵌入一致。 |
| referrerpolicy | 告诉浏览器在 referer 头中发送什么。strict-origin-when-cross-origin 是现代默认值，只暴露来源，绝不暴露完整的页面 URL。 |
| allowfullscreen | 启用播放器的全屏按钮。 |
src 的查询参数是可配置部分。autoplay=1、loop=1&playlist=ID、controls=0、start=秒和 end=秒仅在启用相应选项时出现，因此最简嵌入不携带任何参数。
嵌入选项
设置面板中的每个选项对应最终 URL 中的一个参数。
| 设置 | 参数 | 默认 | 说明 |
|---|---|---|---|
| 宽高比 | – | 16:9 | 预设为 16:9、4:3、3:4、9:16 和 1:1，另有自定义。选择预设会填入该比例的规范尺寸，16:9 变为 560×315，9:16 变为 360×640。 |
| 宽度 / 高度 | – | 560×315 | 编辑任一字段都会根据当前比例重新计算另一个。自定义模式禁用计算，两个值保持独立。范围 144–3840 px。 |
| 无 Cookie 模式 | 主机切换 | 开启 | 使用 www.youtube-nocookie.com，只要视频未播放，YouTube 就不会存储访客信息。 |
| 自动播放 | autoplay=1 | 关闭 | 注意：浏览器仍会阻止带声音的自动播放，请参阅常见问题。 |
| 循环 | loop=1&playlist=ID | 关闭 | playlist 参数会自动添加，没有它 YouTube 会忽略循环。 |
| 显示播放器控件 | 关闭时 controls=0 | 开启 | 关闭后隐藏控制栏，获得干净的播放界面。 |
| 开始时间 | start=秒 | 关闭 | 时、分、秒字段，URL 中会转换为秒。 |
| 结束时间 | end=秒 | 关闭 | 在指定时刻停止播放，无需编辑源视频即可截取片段。 |
宽高自动计算会四舍五入到整数像素并限制在 144–3840 范围内。由于预设是精确比例，560×315 和 360×640 等规范组合是像素级精确的，需要精确尺寸时无需与舍入误差搏斗。
参数参考：2026 年仍然有效的内容
YouTube 已停用的嵌入参数比大多数网站知道的还多，而旧教程仍在推荐失效参数。以下是 2026 年你在网上会遇到的那些参数的实际状态，已与官方播放器文档核对。
仍然有效
| 参数 | 2026 年的效果 |
|---|---|
| autoplay | 启动播放（受浏览器声音策略限制） |
| loop + playlist | 循环播放视频，两者必须保持在一起 |
| controls | 0 隐藏控制栏，2 还隐藏全屏按钮 |
| start / end | 以秒为单位的起点和截止点 |
| cc_load_policy | 1 强制开启字幕 |
| cc_lang_pref | 指定字幕语言 |
| hl | 指定播放器界面语言 |
| color | color=white 将进度条改为白色（仅限控件可见时） |
| fs | 0 隐藏全屏按钮 |
| disablekb | 1 禁用播放器键盘控制 |
| rel | 0 将相关视频限制在同一频道，但无法删除它们 |
已停用且无效
| 参数 | 发生了什么 |
|---|---|
| modestbranding | 2023 年 8 月停用，Logo 始终显示 |
| showinfo | 2018 年 9 月停用，标题始终显示 |
| autohide | 已停用，参数被忽略 |
| theme | 已停用，只有深色播放器 |
| vq | 多年前就已失效，无法再强制初始画质 |
| iv_load_policy | 注释已从 YouTube 移除，该参数已无可控制对象 |
生成器刻意只暴露仍然有效且大多数嵌入者真正需要的参数。功能正常但属于小众的集合（fs、hl、color、disablekb、cc_load_policy）有意保留在界面之外，因为输出是简单的 URL，任何人都可以手动追加 &fs=0 或 &cc_load_policy=1，而不会破坏生成器创建的代码。
使用方法
- 将 YouTube 视频 URL 或单个视频 ID 粘贴到输入框，点击生成按钮或按 Enter。
- 嵌入代码出现在输出区域，实时预览自动在下方打开。
- 调整选项：比例、宽度或高度、无 Cookie 模式、自动播放、循环、控件、开始和结束时间。每次更改代码和预览都会立即更新。
- 检查预览。它是真实的播放器，因此你可以按下播放、快进并直观地验证开始和结束点。
- 点击复制，将 iframe 粘贴到你的页面、CMS 或 HTML 块中。
如果 URL 不包含视频 ID，红色错误消息会说明预期内容。清除会一次性重置输入、代码和预览。
教程
示例一：截取讲座片段并循环。 课程页面需要一段 12 分钟的课程，但源视频长达 40 分钟，相关部分从 3:05 到 12:30，并为想复习的学生循环播放。
- 将 watch URL 粘贴到输入框并点击生成。
- 16:9 比例和宽度 560 已经正确，保留即可。
- 在开始分钟字段输入 3，开始秒字段输入 5。
- 在结束分钟字段输入 12，结束秒字段输入 30。
- 开启循环。
- 代码现在包含 start=185&end=750&loop=1&playlist=VIDEO_ID。
- 复制 iframe 并粘贴到课程页面。
示例二：竖屏格式的 Shorts 视频。 一篇面向移动端的文章嵌入 9:16 的 Shorts。
- 粘贴 Shorts URL，https://www.youtube.com/shorts/... 会像其他链接一样被识别。
- 选择 9:16 比例。宽度自动变为 360，高度变为 640。
- 保持自动播放关闭，移动浏览器反正会阻止它。
- 生成、预览、复制。iframe 呈手机形状，适合为竖屏媒体构建的内容栏。
专业提示
- 无需剪辑即可截取。 start 和 end 创建的片段无需重新编码、无需重新上传、没有画质损失，播放器直接跳到起点并在终点停止。
- 为欧盟流量保留无 Cookie 主机。 youtube-nocookie.com 在视频未播放时不存储访客信息，相比普通域名能减轻同意流程的负担。
- 手动组合自动播放与静音。 如果确实需要 autoplay，请在生成的 src 后追加 &mute=1，浏览器允许静音自动播放，访客轻点即可开启声音。
- 把预览当作质量检查环节。 由于预览是真实播放器，已删除或私密的视频会在那里显示 YouTube 自身的错误消息，而不是将死 iframe 悄悄送入生产环境。
- 卡片和列表的迷你嵌入。 144 px 的最小值支持缩略图大小的播放器，用于悬停预览卡片，而大播放器会破坏这类布局。
- 非常规布局用自定义比例。 侧边栏、竖排文章栏和社交证明区块常常需要非标准尺寸，自定义模式保持宽度和高度独立。
- 批量生成。 URL 留在输入框中，切换选项即可，每次更改都会立即重新生成，因此循环截取版和简洁版 iframe 在几秒内就能得到，而不是几分钟。
替代方案
| 替代方案 | 优点 | 缺点 |
|---|---|---|
| YouTube 官方分享对话框 | 官方出品，始终最新 | 固定 16:9 尺寸、无比例预设、无开始/结束字段、始终 www.youtube.com 主机 |
| YouTube oEmbed | 返回带自动视频标题的 iframe | 需要服务器或 fetch、无法控制参数、需要 JavaScript 基础设施 |
| 手动复制 URL | 无需学习 | 每个选项都是手动 URL 编辑，容易出错，且失效参数潜伏 |
| 本生成器 | 一键完成、比例预设、默认无 Cookie 主机、开始/结束字段、即时预览 | 刻意只支持单视频，不嵌入播放列表 |
与 YouTube 分享对话框对比
YouTube 自家的「分享 → 嵌入」流程在你只需要一个固定 iframe 时没问题。对话框给出 560×315 播放器、一个可切换的复选框和一个 www.youtube.com 的 URL。这就是它的全部能力。
生成器覆盖了对话框根本没有解决的场景：9:16 的 Shorts 播放器、3:4 或 1:1 的方块、精确的像素尺寸、默认的隐私友好主机、无需手动编辑 URL 的开始/结束截取，以及真正有效的循环，因为 playlist 参数会替你添加。对话框能生成的，生成器都能生成，还额外提供对话框没有的实时预览。
嵌入代码生成器与嵌入检查器的区别
本站还提供 YouTube 嵌入检查器，两个工具互补而非竞争。
| 问题 | 嵌入检查器 | 嵌入代码生成器 |
|---|---|---|
| 这个视频到底能不能嵌入？ | 通过 oEmbed、播放器和播放测试给出判定 | 假定可以并生成代码 |
| 视频的标题、作者和时长是什么？ | 会显示 | 按设计不获取元数据 |
| 给我嵌入代码 | 不行，只做诊断 | 可以，选项完全可控 |
| 先验证可疑链接？ | 可以，这是它的职责 | 需要的话可直接粘贴结果 |
当需要确认可嵌入性时先让链接过一遍检查器，需要代码时再过一遍生成器。它们共享同一个 URL 解析器，因此检查器接受的任何内容，生成器也能解析。
它不能做什么
- 获取元数据。 生成器从不调用 YouTube API，因此无法预填标题或作者。它是代码工具而非信息工具，检查器才是做这件事的姊妹工具。
- 嵌入播放列表。 播放列表链接会被拒绝。播放列表嵌入是另一项功能，有自己的参数集，刻意超出单视频工具的范围。
- 编辑 iframe 标题。 title 属性保留 YouTube 官方的「YouTube video player」。屏幕阅读器获得一致的标签，输出与 YouTube 自身发布的内容一致。
- 移除相关视频。 任何参数都做不到，请参阅常见问题。
- 强制自动播放。 浏览器会阻止它，该工具也不会悄悄给你的嵌入添加 mute。
- 上传或保存任何内容。 生成 100 % 在本地进行，请参阅下一节。
故障排除
| 问题 | 可能的原因 | 解决方案 |
|---|---|---|
| 预览显示 YouTube 的「视频不可用」消息 | 视频已删除、为私密或受地区限制 | 嵌入在你的网站上也会同样失败，请换一个视频 |
| 自动播放不启动 | 浏览器阻止带声音的自动播放 | 在生成的 src 后追加 &mute=1 |
| 视频播放一次后停止 | 手动编辑时 loop=1 失去了 playlist 搭档 | 保持 loop=1&playlist=VIDEO_ID 在一起或重新生成 |
| 开始或结束时间被忽略 | 结束早于开始，或片段超过视频时长 | 检查时间顺序和视频时长 |
| 播放器在我的网站上不渲染 | 网站的 Content Security Policy 阻止了 iframe | 向你的 CSP 添加 frame-src https://www.youtube-nocookie.com https://www.youtube.com |
| 播放器渲染但缺少控件 | 控件开关已关闭 | 开启「显示播放器控件」并重新生成 |
| 点击生成没有任何反应 | URL 中没有视频 ID | 使用上表中可接受的格式之一 |
隐私与数据处理
该工具属于本站隐私谱系中最干净的一类：生成期间零请求。
- 生成完全在本地。 URL 在你的浏览器中解析，iframe 在那里组装。不会向 Toollect 服务器发送任何请求，也不会记录任何内容。
- 预览加载真实播放器。 预览打开期间，你的浏览器与 YouTube 的嵌入域名通信，就像任何嵌入了该视频的页面一样。
- 默认主机注重隐私。 生成的代码使用 www.youtube-nocookie.com，除非访客播放视频，否则 YouTube 不会存储他们的信息。关闭隐私选项会切换到 www.youtube.com，即具有通常跟踪行为的同一播放器，这正是官方对话框始终生成的内容。
技术规格
- 输入格式 – watch、embed、Shorts、live、/v/ URL、youtu.be、无 Cookie 域名 URL 和 11 位字符的单个视频 ID。
- 输出 – 单个 iframe 标签，带明确的尺寸、无障碍标题、权限策略和 allowfullscreen。
- 支持的参数 – autoplay、loop + playlist、controls、start、end 以及无 Cookie 模式的主机切换。
- 宽高比 – 16:9、4:3、3:4、9:16、1:1 预设和自由自定义模式，另一侧尺寸按像素取整计算。
- 尺寸范围 – 两个轴均为 144 到 3840 像素。
- 处理方式 – 完全在浏览器中，生成期间无网络请求。
- 浏览器兼容性 – 任何现代浏览器均可使用，生成的代码在任何能渲染 iframe 的浏览器中都能运行，也就是说所有浏览器。
功能特色
- 一键从任意视频 URL 或单个视频 ID 生成 YouTube iframe 嵌入代码
- 宽高比预设，包括 16:9、4:3、3:4、Shorts 适用的 9:16、1:1 和自定义，另一侧尺寸自动计算
- 默认使用注重隐私的 youtube-nocookie.com 域名
- 无需剪辑即可截取视频，开始和结束时间精确到时:分:秒
- 自动播放、循环和播放器控件选项，复制前可实时预览
- 100 % 在浏览器内生成，无需 API 密钥、无需账户、无需上传