讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 ASP.NET Core MVC 项目中正确添加并显示静态图片

轻敏吖_1371

轻敏吖_1371

发布时间:2026-01-22 12:57:29

|

695人浏览过

|

来源于php中文网

原创

在 ASP.NET Core MVC 项目中,静态资源(如图片、CSS、JavaScript)必须存放在 `wwwroot` 文件夹下,这是框架默认的静态文件根目录。你之前使用的绝对路径 `如何在 ASP.NET Core MVC 项目中正确添加并显示静态图片
` 是服务器本地路径,浏览器无法直接访问,因此图片必然无法加载。

要正确添加并显示图片,请按以下步骤操作:

  1. 将图片放入 wwwroot 目录结构中
    在解决方案资源管理器中,找到或创建 wwwroot/images/ 子文件夹(推荐按类型组织),然后将 cars.jpg 拖入该文件夹。最终路径应为:
    YourProject/wwwroot/images/cars.jpg

  2. 在视图中使用正确的 URL 路径
    使用 ~(波浪号)表示应用根路径,并配合 asp-append-version="true" 提升缓存可靠性(可选但推荐):

    <img src="~/images/cars.jpg" class="card-img" alt="汽车图片" />
    ✅ 注意:~/ 由 ASP.NET Core 的标签助手自动解析为 /(即网站根路径),最终生成类似 /images/cars.jpg 的 URL,由 StaticFileMiddleware 正确提供服务。
  3. 确保已启用静态文件中间件(默认已启用)
    检查 Program.cs 中是否包含以下代码(.NET 6+):

    var builder = WebApplication.CreateBuilder(args);
    builder.Services.AddControllersWithViews();
    
    var app = builder.Build();
    if (!app.Environment.IsDevelopment())
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }
    app.UseHttpsRedirection();
    app.UseStaticFiles(); // ← 关键:必须启用!
    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
    app.Run();

⚠️ 常见错误提醒:

  • ❌ 不要使用 file:// 协议或 C:\... 绝对路径;
  • ❌ 不要将图片放在 Controllers、Models 或 Views 等非 wwwroot 文件夹中;
  • ❌ 不要在 src 中硬编码 http://localhost:5000/images/... —— 这会破坏部署灵活性。

✅ 最佳实践建议:

前端设计引擎
前端设计引擎

使用此技能可创建独具特色、具备生产级质量的前端界面,设计品质高。当用户要求构建网页组件、页面、产物、海报或应用程序时(例如:网站、落地页、仪表盘、React 组件、HTML/CSS 布局,或对任意 Web UI 进行样式优化与视觉美化),请启用该能力。输出需为富有创意、精雕细琢的代码与 UI 设计,避免千篇一律的 AI 风格。

下载
  • 图片统一存于 wwwroot/images/,命名使用小写字母与短横线(如 hero-banner.jpg);
  • 在 Razor 视图中优先使用 如何在 ASP.NET Core MVC 项目中正确添加并显示静态图片 防止客户端缓存旧图;
  • 若需动态路径,可结合 IWebHostEnvironment.WebRootPath 在后台获取物理路径(仅限服务端逻辑,不可用于前端 src)。

完成上述配置后,刷新页面,图片即可正常显示。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

689

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

644

2025.12.18

ThinkPHP中间件机制与请求拦截处理实践
ThinkPHP中间件机制与请求拦截处理实践

本专题围绕 ThinkPHP 中间件体系展开,深入讲解中间件的定义、注册与执行流程。内容包括全局中间件与路由中间件的区别、请求前后处理逻辑、自定义中间件开发以及权限验证与日志处理应用。通过实际案例,帮助开发者掌握中间件在项目中的核心作用与最佳实践。

458

2026.03.31

append用法
append用法

append是一个常用的命令行工具,用于将一个文件的内容追加到另一个文件的末尾。想了解更多append用法相关内容,可以阅读本专题下面的文章。

618

2023.10.25

python中append的用法
python中append的用法

在Python中,append()是列表对象的一个方法,用于向列表末尾添加一个元素。想了解更多append的更多内容,可以阅读本专题下面的文章。

1496

2023.11.14

python中append的含义
python中append的含义

本专题整合了python中append的相关内容,阅读专题下面的文章了解更多详细内容。

2844

2025.09.12

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3803

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

954

2023.11.14

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 6.1万人学习

CSS教程
CSS教程

共754课时 | 99.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn