正确做法是将前置逻辑写成MSBuild目标（Target），通过BeforeTargets="CoreCompile"注入任务流；使用Exec调用脚本，路径用$(MSBuildThisFileDirectory)确保跨目录安全；tasks.json的preLaunchTask不参与MSBuild生命周期，仅影响调试启动。
如何在 VSCode 中让 MSBuild 执行自定义前置脚本
VSCode 本身不直接调度 MSBuild，真正触发构建的是 dotnet build 或 msbuild 命令——而自定义前置逻辑必须注入到 MSBuild 的任务流中，不是靠 VSCode 配置文件（如 tasks.json）“拦截”或“加壳”实现的。
常见误区是试图在 tasks.json 里用 command 调用一个 shell 脚本再执行 dotnet build，这看似能跑通，但会绕过 MSBuild 的增量编译、目标依赖和属性传递机制，导致后续构建失效或资源生成错乱。
- 正确做法：把前置逻辑写成 MSBuild 目标（
Target），并指定BeforeTargets="CoreCompile"或BeforeTargets="Build" - 脚本类型支持：可直接内联
Exec调用bash/pwsh/cmd，也可封装为.targets文件复用 - 注意路径：MSBuild 工作目录是项目文件（
.csproj）所在目录，不是 VSCode 打开的根目录，避免硬编码绝对路径
在 .csproj 中注入 Exec 任务执行 Shell/PowerShell 脚本
Exec 是最轻量的前置执行方式，适合单次、简单操作（如生成版本号、清理临时目录、调用 git describe 写入 AssemblyInfo.cs）。
示例：在 .csproj 底部添加以下内容，会在编译前运行 PowerShell 脚本：
<Target Name="PreBuildScript" BeforeTargets="CoreCompile"> <Exec Command="pwsh -ExecutionPolicy Bypass -File $(MSBuildThisFileDirectory)scripts\prebuild.ps1" /> </Target>
-
BeforeTargets="CoreCompile"确保在 C# 编译器介入前执行；用BeforeTargets="Build"则更早，但可能错过某些属性初始化 -
$(MSBuildThisFileDirectory)是安全路径变量，指向当前.csproj所在目录，避免./scripts/在不同工作目录下失效 - Windows 上若用
cmd，需确保命令无空格或用引号包裹；macOS/Linux 注意pwsh是否已安装并加入 PATH - 失败时默认中断构建：添加
IgnoreExitCode="false"（默认值）即可；若允许失败，设为true，但需额外判断逻辑
为什么 tasks.json 里的 preLaunchTask 不适用于 MSBuild 前置逻辑
tasks.json 中定义的 preLaunchTask 只影响调试启动流程（即按 F5 启动前），它和 dotnet build 是否执行、何时执行、是否参与增量编译完全无关。即使你把它设为 "group": "build"，也仅是 VSCode UI 分组标识，不会注入 MSBuild 生命周期。
- 典型误用：在
tasks.json里定义一个shell类型 task 去跑脚本，再配一个dotnettask 执行 build —— 这两个 task 是串行独立进程，彼此不共享环境变量、MSBuild 属性或中间产物 - 后果：脚本生成的
Version.g.cs文件可能被编译器忽略，因为 MSBuild 没声明该文件为Compile项，也不会触发重编译监听 - 真正需要的是 MSBuild 级别的依赖声明，例如：
<Compile Include="Version.g.cs" />必须出现在Target内部或通过<ItemGroup>动态注入
跨平台脚本兼容性与 MSBuild 属性传递的关键点
PowerShell 脚本在 Linux/macOS 上需 pwsh，而 Windows 默认只有 powershell.exe；直接写死命令容易在 CI 或其他开发者机器上失败。更稳妥的方式是用 MSBuild 条件判断 + 统一入口脚本。
- 推荐结构：统一用
prebuild.sh（Linux/macOS）和prebuild.cmd（Windows），然后在.csproj中根据$(OS)选择执行哪个 - 向脚本传参要用 MSBuild 属性：例如
<Exec Command="pwsh -File ... -ProjectDir "$(MSBuildThisFileDirectory)"" />，双引号必须转义为"，否则 XML 解析失败 - 脚本输出想被后续 MSBuild 步骤读取？不能靠 stdout 直接捕获——得写入文件，再用
<PropertyGroup><MyProp>...</MyProp></PropertyGroup>配合<XmlPeek>或<ReadLinesFromFile>加载 - 调试技巧：在
Target内加<Message Text="Running prebuild..." Importance="high" />，配合dotnet build -v:m查看日志确认是否触发
MSBuild 的任务流不是黑盒，但它的执行时机和上下文比表面看起来更严格。把脚本塞进正确的 BeforeTargets、用对路径变量、不绕过项目系统——这三件事没做对，后面所有逻辑都会漂移。
