Rocket框架如何通过文件名加载并展示独立HTML网页文件

你可以根据使用场景，从以下三种常用方案中选择： #

方案1：运行时读取本地HTML文件（无额外依赖，适合纯静态页面） #

这个方案不需要引入第三方库，直接读取磁盘上的HTML文件返回即可。

1. 先调整项目结构，在和Cargo.toml同级的根目录新建static文件夹，把之前写在源码里的HTML内容存为static/index.html。
2. 修改路由处理逻辑，用标准库读取文件内容返回：

use rocket::{get, launch, routes};
use rocket::response::content::RawHtml;
use std::fs;

#[get("/")]
fn index() -> RawHtml<String> {
    let html = fs::read_to_string("static/index.html")
        .expect("无法读取index.html，请检查文件路径是否正确");
    RawHtml(html)
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/", routes![index])
}

如果要托管一整个目录的静态HTML、CSS、JS资源，直接用Rocket内置的FileServer即可，不需要为每个文件单独写路由，根路径会自动识别目录下的index.html作为默认首页：

use rocket::launch;
use rocket::fs::{FileServer, relative};

#[launch]
fn rocket() -> _ {
    rocket::build()
        .mount("/", FileServer::from(relative!("static")))
}

注意：这个方案读取的是程序运行时工作目录下的文件，本地开发用cargo run启动时工作目录默认是项目根目录，可以正常找到文件；生产部署时需要把static文件夹和编译出的可执行文件放在同级目录，或者配置固定绝对路径，避免出现文件找不到的错误。如果对外提供服务，要做好路径校验，防止路径遍历漏洞。

方案2：编译期嵌入HTML到二进制（单文件部署） #

如果不想部署时额外携带静态文件目录，希望编译出单个可执行文件就能运行，可以用Rust内置的include_str!宏，在编译阶段就把HTML内容嵌入到二进制文件中，运行时不依赖本地磁盘文件：

1. 在项目根目录新建templates文件夹，存入index.html文件。
2. 修改路由代码：

use rocket::{get, launch, routes};
use rocket::response::content::RawHtml;

#[get("/")]
fn index() -> RawHtml<&'static str> {
    // 注意路径是相对于当前rs文件的位置，src/main.rs引用根目录下的文件需要加../
    RawHtml(include_str!("../templates/index.html"))
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/", routes![index])
}

注意：这个方案修改HTML内容后必须重新编译程序才能生效，适合内容固定、不需要经常改动的静态页面。

方案3：使用模板引擎（支持动态内容，生产环境推荐） #

如果页面需要动态填充数据（比如展示用户信息、列表内容），直接用Rocket官方维护的模板库rocket_dyn_templates即可，支持Tera、Handlebars等主流模板语法，自带开发环境热重载、生产环境模板缓存能力。

1. 先在Cargo.toml中添加依赖：

[dependencies]
rocket = "0.5.0"
rocket_dyn_templates = { version = "0.1.0", features = ["tera"] }

2. 在项目根目录新建templates文件夹，创建模板文件index.html.tera，支持动态变量占位：

<h1>Hello, {{ username }}</h1>

3. 修改启动和路由代码，挂载模板引擎插件：

use rocket::{get, launch, routes};
use rocket_dyn_templates::{Template, context};

#[get("/<username>")]
fn index(username: &str) -> Template {
    // 传入动态参数渲染模板
    Template::render("index", context! { username })
}

#[launch]
fn rocket() -> _ {
    rocket::build()
        .attach(Template::fairing()) // 挂载模板引擎，默认读取templates目录下的模板
        .mount("/", routes![index])
}

开发模式下修改模板文件不需要重新编译，刷新页面即可看到改动，适合绝大多数Web页面场景。

内容的提问来源于stack exchange，提问作者Gaurav Chandrashekar