visual studio 不自带 sql server，必须安装 sql server（推荐 developer 或 express 版）及 ssms，并在 vs 安装时启用“数据存储和处理”工作负载；连接失败主因是服务未运行、实例名错误、身份验证配置不当或权限不足。

Visual Studio 本身不自带 SQL Server，必须手动配置连接和开发支持，否则“服务器资源管理器”里看不到数据库节点，SqlConnection 会直接报 System.Data.SqlClient.SqlException。

安装 SQL Server 和 SSMS 是前置硬要求

VS 只是开发界面，SQL Server 才是真正跑数据库的引擎。没装服务端，VS 连“localhost”都连不上。

• SQL Server 推荐用 Developer 版（免费，功能完整），或 Express 版（免费但有资源限制）；安装时务必勾选“SQL Server 数据库引擎”和“SQL Server Management Studio（SSMS）”
• SSMS 不是可选工具——它用来建库、写表、查数据、看错误日志，VS 的“服务器资源管理器”连不了本地实例时，你得靠 SSMS 确认服务是否真在运行、登录是否成功
• 如果只装了 VS 而没装 SQL Server，Server=localhost 或 Server=. 一定会失败，错误信息通常是 A network-related or instance-specific error occurred

VS 里必须启用“数据存储和处理”工作负载

VS 安装时默认不包含数据库开发组件，System.Data.SqlClient 命名空间、SQL Server 项目模板、“服务器资源管理器”的数据库节点，全靠这个工作负载激活。

Visual Studio Professional 18.8.1

Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。

下载

• 打开 Visual Studio Installer → 修改当前 VS 版本 → 勾选“数据存储和处理”→ 点击“修改”
• 装完后重启 VS，再打开“视图 → 服务器资源管理器”，右键“数据连接”才能看到“添加连接”选项
• 若跳过这步，新建项目时搜不到 SQL Server Database Project 模板，NuGet 里装了 System.Data.SqlClient 包也没法在设计器里拖表、没法用 SSDT 功能

连接字符串里不能写错实例名和认证方式

最常见的连不上，不是代码写错，而是连接字符串里实例名或身份验证填错了。Windows 身份验证和 SQL Server 账户是两套完全独立的体系。

• 本地默认实例：用 Server=. 或 Server=localhost；命名实例（如 SQLExpress）必须写全，比如 Server=localhost\SQLEXPRESS（注意双反斜杠）
• Windows 身份验证：连接字符串里加 Integrated Security=true，不用写 User ID 和 Password；此时 VS 必须以当前 Windows 用户权限运行
• SQL Server 账户验证：必须提前在 SSMS 里为该账户开启“SQL Server 和 Windows 身份验证模式”，并设好密码，连接字符串里写 User ID=sa;Password=xxx
• 测试连接前，先在 SSMS 里用同样参数试一次——如果 SSMS 都登不进，VS 肯定也连不上

App.config 或 appsettings.json 里存连接字符串要避开路径硬编码

把连接字符串写死在代码里（比如 "Data Source=..."）会导致部署时改代码，极难维护。但直接往配置文件里一贴也不行，容易暴露敏感信息或引发路径解析错误。

• 推荐用 <connectionstrings></connectionstrings> 节点存，例如：

  <connectionstrings><add name="DefaultConnection" connectionstring="Server=localhost\SQLEXPRESS;Database=StudentDB;Integrated Security=true;" providername="System.Data.SqlClient"></add></connectionstrings>

• 不要在连接字符串里写绝对路径（如 FILENAME='C:datamydb.mdf'），SQL Server 实例自己管文件位置，应用层只关心逻辑库名
• .NET 6+ 项目优先用 appsettings.json，但要注意 SqlConnectionStringBuilder 对 JSON 中反斜杠的转义问题，建议用 @"" 字符串或双反斜杠
• 调试时用 ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString 读取，别手敲拼接

真正卡住人的从来不是语法，而是 VS 和 SQL Server 两个进程之间的“信任链”没打通：SQL Server 服务没启、防火墙拦了端口、实例名拼错、Windows 登录用户没被 SQL Server 授权——这些都比写错一个 SqlCommand 参数更常导致失败。