如何在Arduino中#include不带分隔符的原始字符串内容？

问题现状 #

当前项目中网页部分的代码结构如下：

主文件代码：

const char index_html[] = 
#include "index.html.h"
;

index.html.h内容：

R"MaRkEr(<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
...
</body>
</html>)MaRkEr"

这段代码能正常运行，但存在严重调试痛点：

• 无法直接在浏览器预览HTML内容，因为文件被包裹在原始字符串标记中，且扩展名是.h
• 每次修改HTML都要上传到微控制器，耗时极长
• 尝试过用#define定义首尾片段、拆分#include等方法，均未解决问题

可行解决方案 #

方法：拆分原始字符串标记，分离纯HTML内容 #

利用C预处理器的宏连接特性，把原始字符串的首尾标记放在主文件中，让index.html.h只保留纯HTML内容，同时通过文件链接解决预览问题。

1. 修改主文件代码：

// 定义原始字符串的首尾标记（可自定义唯一名称）
#define HTML_START R"HTMLMarker("
#define HTML_END ")HTMLMarker"

// 预处理器会先展开#include内容，再拼接成完整原始字符串
const char index_html[] = HTML_START
#include "index.html.h"
HTML_END;

2. 修改index.html.h为纯HTML内容（无需转义<等特殊字符）：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Your Project Page</title>
    <!-- 其他头部资源 -->
</head>
<body>
    <!-- 页面内容 -->
</body>
</html>

3. 创建文件链接实现浏览器预览：
   • Windows：打开命令提示符，执行 mklink index.html index.html.h 创建软链接
   • Linux/macOS：执行 ln -s index.html.h index.html 创建符号链接

这样做的核心优势：

• 直接打开index.html就能在浏览器预览效果，修改后自动同步到index.html.h
• 预处理器自动完成原始字符串的包裹，无需手动转义HTML特殊字符
• 完全符合Arduino对.h扩展名的要求

注意事项 #

确保HTML内容中没有和你定义的标记（比如HTMLMarker）完全一致的字符串，避免原始字符串提前终止。如果有冲突，换一个更独特的标记名称即可。

内容的提问来源于stack exchange，提问作者SF.