visual studio 创建第一个项目的关键是选对模板、装对工作负载、填对目标框架;三者不匹配会导致模板不可见或创建失败,务必先确认安装对应组件(如.net桌面开发)、语言/平台/类型筛选一致,并选用兼容的目标框架。

Visual Studio 创建第一个开发项目,关键不是“能不能”,而是**选对模板、装对工作负载、填对目标框架**。没装对应组件或选错语言平台,点一百次“创建”也卡在空白页。
选模板前先确认安装了对应工作负载
新建项目失败最常见的原因是:模板根本没装上。比如想建 Windows 窗体应用(.NET Framework),但本地只装了 .NET Core 工作负载,那这个模板就不会出现在列表里。
- 打开 Visual Studio 安装程序 → 修改已安装版本 → 勾选
.NET 桌面开发(含 WinForms/WPF) - 若要建
ASP.NET Core Web 应用,必须勾选ASP.NET 和 Web 开发 - 建
C++ 控制台应用?得装使用 C++ 的桌面开发 - 建
Azure Functions?安装时需包含Azure 开发工作负载
创建项目时语言/平台/项目类型三者必须匹配
新版 Visual Studio 的模板筛选逻辑很严格:三个下拉项(语言、平台、项目类型)是联动过滤的。比如选了 C# + Windows + 控制台,才可能看到 控制台应用(.NET 8.0);但如果平台选成 Web,哪怕语言还是 C#,控制台模板也不会出现。
Visual Studio 18.8.1 官方固定版本安装引导程序,当前条目使用微软发布历史中的 Professional Web Installer,适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
- 搜索框输入关键词比手动翻列表更可靠,例如搜
winforms、razor pages、azure functions -
Windows 窗体应用(.NET Framework)和Windows 窗体应用(.NET 6.0+)是两个不同模板,后者不支持System.Drawing.Common的某些旧 API - 新建
空解决方案后再添加项目,适合多语言混编场景,但初学者建议直接建带默认文件的项目模板
配置新项目时目标框架不能随便选
目标框架(Target Framework)不是“越高越好”。选错会导致编译通过但运行时报 System.MissingMethodException 或引用不到类库。
- 新建
Windows 窗体应用时,若选.NET 10.0(预发布版),部分设计器控件可能无法加载 -
.NET Framework 4.7.2项目无法直接引用.NET 5+类库,反之亦然 - 团队协作中,务必和现有项目保持一致;个人学习可优先选 LTS 版本,如
.NET 8.0 - 项目名称中避免空格、中文、连字符——
My-App会变成无效命名空间,导致生成失败
Program.cs(或 Form1.cs)能正常打开、设计器能加载、F5 能跑出窗口或控制台输出。很多“项目创建失败”的反馈,其实卡在后续步骤——比如没装 .NET SDK、防火墙拦截调试端口、或杀毒软件误删临时生成文件。










