HTML本身不能直接运行函数，需依赖JavaScript引擎；树莓派需通过浏览器（如Chromium）执行JS，或搭配Flask/Node.js服务端控制GPIO，注意权限、CORS及执行环境。
HTML 本身没有“函数”可直接在树莓派上“运行”——你真正想做的，是让树莓派执行 HTML 页面中嵌入的 JavaScript 逻辑，或通过浏览器/服务端触发对应行为。
为什么浏览器里能点按钮就弹窗，树莓派却没反应？
HTML 是标记语言，onclick、addEventListener 这类行为依赖 JavaScript 引擎执行，而引擎必须由宿主环境提供（比如 Chromium、Node.js）。树莓派裸机不自带运行时，直接双击 index.html 可能用的是系统默认查看器（如 epiphany-browser 或 firefox-esr），但若未启用 JS、或页面用了现代 API（如 fetch 跨域限制、localStorage 权限），就会静默失败。
- 检查是否真在浏览器中打开：用
chromium-browser --no-sandbox --disable-web-security /path/to/index.html启动（仅测试用） - 确认
<script>标签没写成<script type="text/javascript">且被旧版浏览器忽略（现代 Chromium 不要求 type） - 打开开发者工具（
F12→ Console），看是否有ReferenceError或DOMException
想让树莓派“执行 HTML 函数”，实际走哪几条路？
取决于你要触发的是前端交互，还是后端动作（比如控制 GPIO）。常见路径有三类，不能混用：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
纯前端：用
chromium-browser打开 HTML + JS，所有逻辑在浏览器内完成（如计时器、表单验证） -
前后端协作：JS 发
fetch('/api/gpio?pin=18&state=1')，树莓派上跑一个轻量服务（如Flask或Node.js），收到请求后调用RPi.GPIO或gpiozero -
无浏览器方案：用
node直接执行 JS 文件（需把原 HTML 中的document.getElementById等 DOM 操作全删掉），适合做定时任务或 CLI 工具
GPIO 控制最容易踩的坑：权限与上下文
即使 JS 成功发出了请求，后端 Python/Node 脚本也可能报 PermissionError: [Errno 13] Permission denied——因为树莓派默认禁止非 root 用户访问 /dev/gpiomem。
立即学习“前端免费学习笔记（深入）”；
- 加用户进
gpio组：sudo usermod -aG gpio pi，然后重新登录 - 用
gpiozero（推荐）而非底层RPi.GPIO，它自动处理权限和引脚映射 - 别在 Flask 的
@app.route里直接写GPIO.setup(18, GPIO.OUT)—— 每次请求都重初始化会冲突，应提前初始化一次，或用全局变量缓存实例 - 如果用
fetch调后端，确保前端页面协议与后端一致（http://localhost:5000不能从file:///协议加载，会触发 CORS）
真正卡住人的往往不是语法，而是“谁在哪个进程里执行、有没有对应权限、通信链路是否被协议或沙箱截断”。先确认 JS 是否真执行了（console.log），再查网络请求是否发出（Network 面板），最后盯住后端日志——树莓派资源有限，print() 比埋点更可靠。
