要让CodeGeeX帮你生成能直接跑的C++单元测试，光靠点一下“生成”是不够的——它不会自动猜你用的是Google Test还是pytest，也不会替你补上main函数，更不会在你没登录时悄悄返回Python风格的伪代码。先说一个核心判断：必须手动配置，才能让生成的测试真正可运行、覆盖准、风格对。下面一步步拆解。
先让插件“活过来”
打开VS Code，按下Ctrl+Shift+X进入扩展面板，搜索CodeGeeX并确认已安装。关键看状态栏右下角——蓝色鲸鱼图标必须显示“Online”。如果图标灰显或无响应，所有生成操作都是白搭。
接着点击右侧边栏的CodeGeeX图标，在右上角头像处确认账号状态为“Authenticated”。未登录的话，必须用GitHub或邮箱授权，否则/tests指令会被直接忽略。
强制模型理解你的技术栈
CodeGeeX默认倾向于输出Go或Python的测试代码，C++和Ja va项目尤其容易翻车。必须用明确指令锚定框架和语法。
方法一：侧边栏精准提问
在CodeGeeX面板输入以下内容后回车：
/tests for the C++ function above, using Google Test framework, include
方法二：函数内联注释引导
在目标函数上方添加三行注释：
// @framework: google-test
// @include:
// @assert: ASSERT_EQ(result, expected)
然后选中整个函数（包括func关键字、参数和花括号），右键选择“CodeGeeX → Generate Unit Test”。
注意一个细节：如果生成结果中间出现了#include "gtest/gtest.h"，但缺少int main(int argc, char **argv)或testing::InitGoogleTest(&argc, argv)，说明上下文未被完整捕获，需要重试并补全注释。
修复生成代码的致命硬伤
第一步：检查生成的文件名。必须是xxx_test.cpp，不能用.cc、.cxx或.h后缀，且与被测源文件同目录。VSCode的Test Adapter for Google Test插件只识别*_test.cpp文件。
第二步：确认每个TEST宏调用后没有分号。TEST(MyMath, AddPositive) { };是错误写法，必须删掉结尾分号。
第三步：补全入口函数。如果生成代码不含main函数，手动追加：
int main(int argc, char **argv) {
::testing::InitGoogleTest(&argc, argv);
return RUN_ALL_TESTS();
}
让测试贴合项目真实风格
① 打开项目根目录，检查是否存在pyproject.toml或setup.cfg。如果存在，确认其中包含[tool.pytest]或[pytest]区块。
② 如果项目使用conftest.py定义了自定义fixture（比如@pytest.fixture(scope="session")），确保该文件位于tests/目录或其父级，并且已被VS Code Python解释器识别。
③ 在终端中运行python -m pytest --version，输出必须包含“pytest X.Y.Z”字样。如果报错“no module named pytest”，先执行pip install pytest pytest-mock。
五种触发方式怎么选
1. 右键菜单（推荐单个函数）：光标置于def行任意位置，右键选择“CodeGeeX: Generate Unit Test”。注意：此操作必须在.py文件内进行，.ipynb或未保存的临时文件不支持。
2. 侧边栏指令（适合定制输出）：按Ctrl+Shift+C呼出面板，输入/tests for the function above后回车。
3. 注释驱动（提升边界覆盖）：在函数上方添加GoDoc或Ja vadoc注释，明确写出空输入、panic条件、典型示例。CodeGeeX会据此生成t.Run("nil input panics", ...)这类子测试。
4. CLI批量生成（CI/CD场景）：运行codegeex-cli test --file ./src/math_utils.py --function find_max，工具自动解析AST并输出至./tests/test_math_utils.py。
5. 快捷键触发（高频编辑）：在函数前一行插入# @codegeex generate pytest test，确保与def之间无空行，然后按Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS）。