VS Code终端中Flutter Windows项目构建失败问题求助

问题概述 #

Flutter项目在系统PowerShell、CMD、Android Studio终端均可正常编译，但仅在VS Code的PowerShell终端构建失败，报错Unable to find git in your PATH；且VS Code终端本身可正常执行Git命令，回滚代码后问题仍存在，VS Code还标记了windows/runner/CMakeLists.txt第21行错误（Android Studio无此标记）。

核心原因 #

VS Code集成终端的环境变量与系统环境变量未同步，导致Flutter构建流程（如flutter_assemble、CMake）无法读取到Git的PATH配置，即便终端本身能直接调用Git。

解决方案 #

1. 重启VS Code #

VS Code启动时会加载系统环境变量，若后续修改过PATH，重启可让新配置生效，大概率能解决环境变量不同步问题。

2. 临时补全Git路径测试 #

在VS Code的PowerShell终端执行以下命令，手动添加Git的PATH：

$env:PATH += ";C:\Program Files\Git\cmd"

然后重新运行flutter run -d windows，如果能正常构建，说明确实是环境变量未同步。

3. 强制VS Code终端继承系统环境变量 #

打开VS Code设置（快捷键Ctrl+,），搜索terminal.integrated.inheritEnv，确保该选项设置为true，让终端完全继承系统的PATH配置。

4. 清理Flutter构建缓存 #

执行以下命令清理缓存后重新构建：

flutter clean
flutter pub get
flutter run -d windows

5. 检查VS Code的Git路径配置 #

打开VS Code设置，搜索git.path，确保配置的Git路径正确，示例：

"git.path": "C:\\Program Files\\Git\\cmd\\git.exe"

相关代码与日志 #

项目的windows/runner/CMakeLists.txt #

cmake_minimum_required(VERSION 3.14)
project(runner LANGUAGES CXX)

# Define the application target. To change its name, change BINARY_NAME in the
# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer
# work.
#
# Any new source files that you add to the application should be added here.
add_executable(${BINARY_NAME} WIN32
  "flutter_window.cpp"
  "main.cpp"
  "utils.cpp"
  "win32_window.cpp"
  "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc"
  "Runner.rc"
  "runner.exe.manifest"
)

# Apply the standard set of build settings. This can be removed for applications
# that need different build settings.
apply_standard_settings(${BINARY_NAME}) #line 21, broken according to only vscode

# Add preprocessor definitions for the build version.
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}")

# Disable Windows macros that collide with C++ standard library functions.
target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX")

# Add dependency libraries and include directories. Add any application-specific
# dependencies here.
target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app)
target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib")
target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")

# Run the Flutter tool portions of the build. This must not be removed.
add_dependencies(${BINARY_NAME} flutter_assemble)

VS Code PowerShell终端报错日志 #

PS D:\programmingfiles\Project\Project> flutter run -d windows
Launching lib\main.dart on Windows in debug mode...
CUSTOMBUILD : error : Unable to find git in your PATH. [D:\programmingfiles\Project\Project\build\windows\x64\flutter\flutter_assemble.vcxproj]        
D:\visual studio\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(254,5): error MSB8066: Custom build for 'D:\programmingfiles\Project\Project\build\windows\x64\CMakeFiles\ab1312b390e9d01057e733057db02a7c\flutter_windows.dll.rule;D:\programmingfiles\Project\Project\build\windows\x64\CMakeFiles\dcf1585d978e9dd5b1ec90bc6f6e410c\flutter_assemble.rule' exited with code 1. [D:\programmingfiles\Project\Project\build\windows\x64\flutter\flutter_assemble.vcxproj]
Building Windows application...                                    881ms
Error: Build process failed.

系统PowerShell终端成功日志 #

PS D:\programmingfiles\Project\Project> flutter run -d windows
Launching lib\main.dart on Windows in debug mode...
Building Windows application...                                     5.3s
✓ Built build\windows\x64\runner\Debug\project.exe
Syncing files to device Windows...                                  76ms

Flutter run key commands.
r Hot reload. 🔥🔥🔥
R Hot restart.
h List all available interactive commands.
d Detach (terminate "flutter run" but leave application running).
c Clear the screen
q Quit (terminate the application on the device).

A Dart VM Service on Windows is available at: http://127.0.0.1:57134/2XZ8tADElZo=/
The Flutter DevTools debugger and profiler on Windows is available at:
http://127.0.0.1:9102?uri=http://127.0.0.1:57134/2XZ8tADElZo=/

内容的提问来源于Stack Exchange，提问作者匿名用户