校验 MACA 路径配置有效性

[ghangz]

该 PR 对 MACA 相关路径配置增加存在性和可访问性检查，让配置错误在启动早期以清晰信息暴露。

这个修改面向沐曦 GPU 适配场景中比较容易影响开发、构建或验证稳定性的环节，把原来需要人工排查的问题前移到工具链、运行前检查或基准脚本中处理。实现上保持对现有默认行为的兼容，只在检测到明确配置、输入或环境异常时给出更直接的诊断，避免引入额外运行依赖，也方便维护者独立审阅该分支。

已在沐曦算力环境中完成对应分支验证，验证记录包含真实运行日志、命令输出和失败路径检查，本地归档目录为：E:/Documents/muxi/测试报告/vLLM-metax_real_env_validation_20260608。提交分支：mengz/validate-maca-path，目标仓库：MetaX-MACA/vLLM-metax。

[gemini-code-assist]

Code Review

This pull request introduces validation checks for the MACA_PATH environment variable in both CMakeLists.txt and setup.py to ensure the MACA SDK path is valid. The review feedback highlights that these checks are currently unconditional and will break builds in non-MACA environments, such as standard CUDA environments. It is recommended to conditionally perform these checks only when MACA support is explicitly enabled, for example by checking the USE_MACA option.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

在 CMakeLists.txt 中，对 MACA_PATH 的检查是无条件执行的。然而，上面定义了 option(USE_MACA "Enable MACA Support" ON)。如果用户将 USE_MACA 设置为 OFF（例如在非 MACA 的标准 CUDA 环境下进行构建或测试），CMake 仍然会因为 MACA_PATH 为空或不存在而触发 FATAL_ERROR 导致构建失败。

建议将该校验逻辑与 USE_MACA 选项结合，仅在启用 MACA 支持时才进行路径有效性检查，以确保非 MACA 环境下的正常构建。

if (USE_MACA AND ("${MACA_PATH}" STREQUAL "" OR NOT EXISTS "${MACA_PATH}"))
  message(FATAL_ERROR "MACA not found or invalid path, please check your MACA_PATH")
endif()

[gemini-code-assist]

在 get_maca_version() 中，如果环境变量 MACA_PATH 未设置，会直接抛出 RuntimeError。

然而，在 setup.py 中，_is_maca() 的判断逻辑仅依赖于 VLLM_TARGET_DEVICE == "cuda" 和 torch.version.cuda 是否存在。这意味着在标准的 NVIDIA CUDA 环境下，_is_maca() 也会返回 True，从而调用 get_maca_version()。这会导致在非 MACA 的标准 CUDA 环境下执行 setup.py 时，因未设置 MACA_PATH 而无条件抛出 RuntimeError 崩溃。

建议结合全局变量 USE_MACA（通过尝试导入 MACA_HOME 确定是否为真正的 MACA 环境）来进行校验。如果不是真正的 MACA 环境且未设置 MACA_PATH，应允许优雅返回 None，避免破坏标准 CUDA 环境的兼容性。

Suggested change

	maca_path = os.getenv("MACA_PATH")
	if not maca_path:
	raise RuntimeError("MACA_PATH must be set to the MACA SDK root.")
	maca_path = os.getenv("MACA_PATH")
	if not maca_path:
	if USE_MACA:
	raise RuntimeError("MACA_PATH must be set to the MACA SDK root.")
	return None