用vs2019写代码这件事说新不新说旧不旧。虽然VS2022都已经成了默认选项但很多公司内部的老项目、教材里的经典示例、还有一批基于.NET Framework的老代码仍然锁死在vs2019上。再加上不少高校的机房镜像、专业课讲义默认装的也是vs2019每年新生开学都有一波安装求助潮。我把这几年折腾vs2019安装、配置、踩坑的经验整理一下尽量写得细一点覆盖从下载到日常使用的完整流程希望能让刚接触的人少走弯路。这篇内容主要面向三类人刚上大学准备学C/C或者C#的初学者、工作中被要求维护老项目的开发以及需要在多台机器上批量搭建相同开发环境的技术人员。文章会从版本选择和下载开始讲然后拆解在线安装和离线安装的具体步骤接着介绍新建项目、调试、NuGet、Git等日常高频操作最后把安装报错、编译报错、中文乱码、第三方库配置这些常见问题整理成一个速查表。1. 安装前的准备版本、系统要求和下载方案1.1 选对版本比什么都重要vs2019实际上有三个主要版本社区版Community、专业版Professional和企业版Enterprise。社区版对个人开发者、学生、开源贡献者免费功能和专业版几乎一样最大的限制主要在于授权条款——如果你的公司规模超过一定人数或者不是做开源项目就需要付费版本。很多人在网上搜vs2019产品密钥vs2019专业版密钥我这里想多说一句不建议去弄来路不明的激活码。社区版对于学习和大多数个人项目已经够用专业版和企业版可以走微软官方订阅或者直接下载试用版试用期到了接着用社区版也不丢人。开发工具这种基础软件用盗版激活码容易把自己电脑弄得乱七八糟还可能在公司版权检查时出问题完全不值得。版本选型时还要考虑一个点vs2019默认的C编译工具集是v142vs2022是v143vs2015是v140。如果你要编译别人给的工程先看一眼工程的平台工具集是否和本机匹配不匹配会直接报MSB8020错误这个后面常见问题部分会详细说。1.2 系统要求与磁盘空间心里有数vs2019支持Windows 10、Windows 11官方要求是64位系统内存至少4GB但实际体验下来8GB内存只能说是刚好够用16GB会更轻松。磁盘方面只安装C桌面开发这一个工作负载装完大约要占5到8GB空间如果再加上. NET桌面开发、Python开发等负载整个安装目录加共享组件轻轻松松超过20GBC盘吃紧的话要提前规划。建议在安装之前做两件事第一把Windows系统更新打全尤其是.NET Framework运行时相关补丁第二关闭正在运行的程序包括杀毒软件或者至少把安装目录加入白名单。VS安装器在安装过程中会释放大量临时文件杀毒软件扫描会造成安装时间翻倍甚至误报。下载vs2019要注意微软官网主推的是一个几兆字节的引导安装器bootstrapper运行后需要联网拉取真正的组件包。如果网速一般或者需要给多台机器安装强烈建议用离线安装包方案后面会详细讲。2. 安装实操在线安装与离线部署全流程2.1 在线安装工作负载怎么勾选双击下载好的vs_community.exe会进入Visual Studio Installer界面。首次运行时它自己也要更新这一步耐心等就行。进入工作负载标签页后大部分人纠结的是该勾哪些。我的建议是按你当前要写的语言来选别贪多。写C/C勾选使用C的桌面开发写C#/VB.NET桌面程序勾选.NET桌面开发写Python勾选Python开发做Web开发勾选ASP.NET和Web开发写Unity游戏脚本勾选使用Unity的游戏开发右侧的安装详细信息面板会列出当前工作负载包含的组件默认推荐的组件一般够用。需要注意C桌面开发默认带Windows 10 SDK、MSVC v142编译器和CMake工具如果之后发现缺少某样东西可以再打开Visual Studio Installer点修改补充不用卸载重装。安装位置页有个很多人问的点vs2019允许把安装目录改到D盘但只有核心IDE部分能改公共组件、SDK、工具缓存这类会被强制放到C盘的共享组件目录。换句话说别指望把所有东西都挪出C盘。我在实际机器上装的时候选了C桌面开发和. NET桌面开发两个负载最后C盘还是被占掉了大约12GB这就是共享组件加缓存的结果。点击安装后前几分钟进度条可能一直停在正在下载状态这是正常的。vs2019的组件包总量很大加上Windows SDK首次安装花30分钟到1小时都不稀奇。中间如果有组件下载失败Installer通常会在下一次运行时自动续传不用把安装器删了重下。2.2 离线安装用官方layout命令准备安装包如果你在公司内网、校园机房或者网络环境不稳定在线安装会很痛苦这时候应该用--layout参数制作离线镜像。这是微软官方支持的方式没用任何第三方工具。在一台能联网的电脑上先下载vs_community.exe或者其他版本对应安装器打开命令提示符进入安装器所在目录执行vs_community.exe --layout D:\vs2019offline --add Microsoft.VisualStudio.Workload.NativeDesktop --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --lang zh-CN --includeRecommended这里解释一下关键参数--layout D:\vs2019offline指定离线缓存目录下载的组件会全部放在这里--add指定需要的工作负载IDMicrosoft.VisualStudio.Workload.NativeDesktop是C桌面开发ManagedDesktop是. NET桌面开发NetWeb是Web开发--lang zh-CN只下载简体中文语言包不加这个参数会把多国语言都拉下来体积大好几倍--includeRecommended把推荐组件一并包含避免安装时还要联网补下载完成后离线目录里会有一个vs_community.exe把整个目录拷到目标机器双击运行即可离线安装。布局目录里还有vs_setup.exe可以用命令行方式静默安装适合机房批量部署。用layout方式制作离线包有几个细节要注意下载机和安装机最好是相同架构都是64位系统语言和组件列表一定要在下载时就定好安装时如果想加组件但离线目录没有会卡在联网阶段校验方法很简单看目录体积是否和选择的组件数量匹配C桌面开发加. NET桌面开发两个负载离线目录通常在8到10GB。2.3 首次启动配置登录、主题和快捷键安装完成后第一次启动vs2019会弹出一个登录窗口。可以用微软账户登录不想登录也可以点以后再说则会有30天试用期。这个试用期内功能是全开的但到期后建议还是登录一下尤其是社区版用户登录后就能正常免费使用了。接着是开发设置选择页面这里有两个选择一是按语言选比如C#Visual CWeb开发等二是快捷键方案。初次使用者我建议保持默认别手痒去选VSCode或ReSharper快捷键方案等熟悉了再改。主题方面选深色还是浅色看个人喜好这个随时可以在工具-选项-环境里调整。启动完成看到的起始页会显示最近的打开项目、新建项目入口以及一些学习链接。界面右边的解决方案资源管理器是后续最常用的面板如果某天不小心关了可以在视图菜单里重新调出来。3. 快速上手建项目、写代码、编译运行3.1 创建第一个C控制台项目用vs2019写代码核心概念是项目project和解决方案solution。一个解决方案可以包含多个项目项目是编译输出exe或dll的最小单元。新建项目的入口是文件-新建-项目或者直接看起始页的创建新项目。演示一个C例子。在新建项目窗口搜索控制台选择控制台应用注意语言标签要选C项目名称取HelloDemo位置自己定一个工作目录。创建后解决方案资源管理器里能看到HelloDemo项目下面有HelloDemo.cpp、pch.h预编译头等文件。vs2019默认生成的C控制台项目自带预编译头机制pch.h里可以放常用的头文件pch.cpp用来生成预编译头。初学的同学经常看不懂这一步简单理解就是编译器把常用的头文件先编译缓存起来加快后续编译速度。如果嫌它烦可以右键项目-属性-C/C-预编译头把预编译头改成不使用代码里删掉#include pch.h即可。把HelloDemo.cpp改成最简单的内容#include iostream int main() { std::cout Hello VS2019 std::endl; return 0; }点工具栏上绿色的小三角本地Windows调试器快捷键F5会开始编译并运行。如果想直接运行不调试按CtrlF5。第一次编译可能会提示找不到Windows SDK版本或v142工具集这说明安装时漏了组件回Visual Studio Installer补装使用C的桌面开发即可。3.2 调试器上班族和学生的必要技能vs2019的调试器是它的看家本领。在代码行左侧灰色槽点一下会出现红点这就是断点。按F5启动调试程序会停在断点处此时可以查看变量值。鼠标悬停有浮窗底部自动窗口监视局部变量窗口都能看数据右键变量可以加监视之后每次变化都能持续跟踪。调试过程中最常用的是这三个按键F10逐过程不进入函数内部F11逐语句进入函数内部ShiftF5停止调试条件断点是我特别推荐的一个技巧。有些bug只会在特定条件下出现比如循环到第1000次时普通断点要按好多次F5。右键断点红点选条件输入i 1000程序就只在满足条件时停下来排查复杂逻辑非常省时间。3.3 NuGet、Git和扩展日常高频功能C#和C项目都会用到第三方库vs2019把包管理工具做进了IDE。右键项目-管理NuGet程序包浏览搜Newtonsoft.JsonZlib之类选中安装即可。NuGet会自动下载机制对应的库文件并配置引用路径。国内网络访问NuGet官方源偶尔慢可以在设置里改成阿里的NuGet镜像源这个网上搜一下就有步骤不复杂。代码管理的Git集成也是每天要用到的。打开视图-团队资源管理器可以克隆远程仓库、创建分支、提交代码、推送和拉取。右键文件还能看历史版本、比较差异。vs2019的Git面板虽然不如专门工具强大但90%的日常操作已经足够对新手来说不用额外折腾Git客户端。扩展市场方面扩展-管理扩展里可以装很多提升效率的插件。常用的有代码格式化工具、主题配色、编辑器增强类插件。我个人的建议是新手先装一个汉化语言包就行其他扩展等对IDE熟悉了再挑。4. 常见编译错误与运行问题排查4.1 安装和启动阶段的问题错误0x80070643安装时最常见的错误之一通常和Windows Installer服务、磁盘空间或杀毒软件有关。优先检查C盘剩余空间然后以管理员身份运行安装器再关掉杀毒软件重试。还不行就用控制面板-程序和功能把已验证的Visual Studio Installer卸载干净重新装。启动提示sxs.dll或Side-by-Side configuration is incorrect一般是VC运行库缺失把微软常用的Visual C Redistributable for Visual Studio 2015-2022装一遍基本能解决。运行库和vs2019本身是两回事运行库是让编译出的程序在目标机器上跑起来的必备运行时。安装卡在99%或者进度条长时间不动先在任务管理器看网络和磁盘占用如果在持续读写说明还在工作。如果确信卡死不要直接强杀先点安装器的取消按钮等它回滚。回滚消息提示缺少组件时记录组件名称这是判断安装问题的关键线索。4.2 编译链接错误MSB8020典型提示是项目要求v142平台工具集但其未安装。原因就是本机没有对应版本的编译工具或者工程工具集版本和本机不匹配。解决方式有两种一是安装对应工作负载二是在项目属性-常规-平台工具集里切换到本机已安装的版本比如把v142改成v143但要注意老代码不一定能兼容新工具集可能引入新编译错误。LNK1104报错内容是无法打开文件xxx.lib。发生场景通常是把别人的C工程拉到自己机器上打开第三方库路径失效。此时右键项目-属性找到链接器-常规-附加库目录把对应的lib目录填进去同时在链接器-输入-附加依赖项里确认库文件名。这个问题在配置freeglut、OpenCV等第三方库时几乎必遇一次。error C4996提示某函数不安全比如strcpy、scanf、sprintf。vs2019默认启用SDL安全检查对老代码很不友好。两种处理一是在预处理器定义里加_CRT_SECURE_NO_WARNINGS让警告消失二是把函数换成微软推荐的安全版本比如strcpy_s。我个人倾向第二种但老项目改动大时用第一种顶着把风险记录在注释里。4.3 中文乱码问题在vs2019里写中文注释经常出现编译警告C4819或者控制台输出的中文变成乱码。根因是源文件编码和系统代码页不一致。Windows中文系统默认使用GBK代码页936而vs2019新建的源文件可能是UTF-8无签名两者互不兼容。推荐的处理办法是在项目属性-C/C-命令行附加选项里加上/utf-8强制编译器按UTF-8解析源文件。这样不管系统区域设置如何中文都能正常注释和输出。另一个办法是使用文件-高级保存选项把源文件另存为Unicode (UTF-8带签名)-代码页65001。如果这两种都解决不了输出乱码检查一下控制台活动代码页在命令行执行chcp 65001再运行程序。4.4 第三方库配置以freeglut为例freeglut是OpenGL的实用工具箱库很多图形学课程都用它。在vs2019里配置freeglut思路完全可以套用到OpenCV、GLEW、SDL等一大堆库上。第一步下载freeglut的Windows二进制包或者源码自己编译。解压之后目录里会有include、lib、bin三个主要文件夹。第二步右键C项目-属性C/C-常规-附加包含目录填freeglut的include目录链接器-常规-附加库目录填freeglut的lib目录注意Debug和Release、x86和x64要分开链接器-输入-附加依赖项freeglutd.libDebug版或freeglut.libRelease版 第三步项目里添加宏定义FREEGLUT_STATIC如果用静态库的话并把freeglut.dll动态库复制到exe生成目录。这套步骤网上到处都是但真正容易错的是Debug和Release库的混用。vs2019默认的解决方案配置是Debug你如果把Release版本的freeglut.lib链接到Debug程序里链接时会报一堆无法解析的外部符号这个问题忽略配置环境而在Debug目录找了半天库的人很多。5. 进阶场景安装包制作与多语言工具链协同5.1 创建安装包项目TargetPath和OutputFilevs2019自带的功能里没有过去那个安装和部署项目需要先在扩展-管理扩展里搜索安装官方的Microsoft Visual Studio Installer Projects扩展。装好重启后新建项目窗口会出现其他项目类型-Visual Studio Installer-Setup Project。安装项目建好后右键项目-添加-项目输出-主输出选择你要打包的应用程序项目。这时文件系统编辑器里会出现应用程序文件夹里面就是主输出文件。在文件系统编辑器里选中它属性窗口能看到TargetPath和OutputFile这两个关键属性。TargetPath表示该文件在目标机器上的安装路径也就是安装后exe最终放在哪个文件夹。可以手动改成[ProgramFilesFolder]你的公司名产品名或[WindowsFolder]System32等方括号里的是Windows Installer自带的目标文件夹宏OutputFile指的是打包工程生成安装包.msi或.exe的输出路径一般在项目Release目录下配置完产品名、产品作者、版本号后右键安装项目点生成目录下会生成安装程序。想创建桌面快捷方式的话在应用程序文件夹里右键主输出选创建快捷方式把快捷方式拖到用户桌面文件夹即可。这个流程做一次之后每次打包只需要改版本号重新生成效率非常高。5.2 vs2019与Python、其他工具链的协同vs2019安装Python工作负载后可以直接打开.py文件带语法高亮、代码补全和调试功能。它还能识别conda环境和venv虚拟环境写Python脚本时不用切出IDE。初次打开.py文件时底部提示选择解释器如果找不到在工具-选项-Python-环境里手动添加。有些同学是学Fluent做CFD的Fluent的UDF编译会依赖VS的C编译环境。如果编译UDF时提示找不到cl.exe或者nmake大概率是udf.bat里写的VS安装路径不对。把udf.bat里的路径改成vs2019实际安装目录下VC\Auxiliary\Build\vcvars64.bat的位置即可比如D:\Program Files\VS2019\VC\Auxiliary\Build\vcvars64.bat。视频里很多教程还提到搭配CMake使用。vs2019直接支持打开CMakeLists.txt打开后会自动配置CMake缓存之后可以直接用vs2019的调试器跑CMake目标。对跨平台项目来说这个能力非常关键——你不需要额外装别的编辑器一个vs2019就完成从编辑到调试的全流程。最后说一个我在多台机器上维护vs2019的真实体会不管安装还是卸载全程都能用用的舒服核心是第一次安装时别贪多、别乱加离线包一定要提前用layout命令备好遇到问题先从组件缺失和工具集版本两个方向排查。把这几点理顺vs2019这台老将还能安安稳稳陪你很多年。