CJASTHelper Windows构建指南基于llvm-mingw工具链快速上手【免费下载链接】CJASTHelperCangjie Abstract Syntax Tree Helper项目地址: https://gitcode.com/Cangjie-SIG/CJASTHelperCJASTHelperCangjie Abstract Syntax Tree Helper是基于 Cangjie 开源编译器前端的 AST 操作与源码转换工具提供多阶段源码打印、AST 转储、纯语法检查与 Pass 插件化分析管线。本文带你用llvm-mingw 工具链 CMake Ninja在 Windows 上完成 CJASTHelper 的快速构建从环境配置到产出可运行的cjah.exe并附常见构建问题速查清单。1️⃣ 构建前必备4 项依赖一次备齐在开始之前请确认本机已准备以下依赖。CJASTHelper 的 Windows 构建走 clang 交叉编译路线而不是 MSVC这一点决定了工具链的选择依赖要求说明llvm-mingw 工具链必须为 20220906 版本、msvcrt 后端提供x86_64-w64-mingw32-clang/clang、llvm-ar、llvm-ranlib并随包提供libssp-0.dllCangjie Windows SDK需为官方完整 SDK提供 C 头文件、导入库libcangjie-lsp.dll.a与运行时libcangjie-lsp.dllCMake3.16.5 及以上构建系统Ninja任意新版构建执行器可用 Scoop 安装⚠️关键提醒请勿混用其它版本或 ucrt 后端构建的 llvm-mingw 工具链。运行时依赖libssp-0.dll、libc.dll等与 ABI 行为均以 20220906 msvcrt 后端为准混用会触发难排查的链接或运行问题。CMake 中对编译器的引用见 CMakeLists.txt。关于工具链来源与 SDK 版本细节建议直接阅读官方文档 doc/build-windows.md其中对依赖版本有权威说明。2️⃣ 环境路径配置只需改一个文件CJASTHelper 把机器相关的路径全部集中在 scripts/win_env.ps1 中由 build.ps1 自动加载第 26 行dot-source引入构建脚本内不再出现任何硬编码路径。你只需按本机情况修改这几个变量变量示例值指向什么MINGW_BIND:/sdks/llvm-mingw-20220906-msvcrt-x86_64/binllvm-mingw 的 bin 目录CANGJIE_HOMED:/sdks/cangjieCangjie SDK 根目录SCOOP_SHIMSC:/Users/name/scoop/shimsninja 所在 shims 目录自动追加进 PATHGTEST_RELEASE_PATHD:/sdks/googletestgoogletest 预编译目录仅测试构建-g需要路径解析优先级同名环境变量 文件内默认值。也就是说不动文件也能临时切换环境非常适合 CI 或多 SDK 并存的场景$env:MINGW_BIN D:/sdks/llvm-mingw-15/bin $env:CANGJIE_HOME D:/sdks/cangjie powershell -File build.ps1 -t Debug -b⚠️最重要的一条规则CANGJIE_HOME必须与提供编译头文件的 SDK 是同一套。编译按头文件定义的类布局构造CompilerInvocation等对象运行时跨 DLL 传给libcangjie-lsp.dll。若头文件与动态库来自不同 SDK 版本类成员偏移不一致程序会在启动后直接段错误SIGSEGV退出码 139这是 Windows 上最高频的疑难杂症。3️⃣ 一键构建build.bat 三步全自动路径配置好后构建入口就是 build.bat——它是 build.ps1 的薄包装双击友好、命令行通用# Debug 构建默认 build.bat -b -t Debug # Release 构建 build.bat -b -t Release # 构建并安装到 output/ 目录 powershell -File build.ps1 -t Release -ibuild.ps1的选项与 Linux 版build.sh完全一致同一命令可直接跨平台复用常用选项如下选项说明-v打印实际执行的构建命令-g开启 googletest 测试构建-t构建类型Debug/Release默认 Debug-d覆盖 Cangjie 库路径Windows 下会同时统一CANGJIE_HOME防跨 SDK ABI 崩溃-b仅构建-i构建并安装到output/-c清理build/与output/-r构建后直接运行 cjah参数放在--之后一次成功的构建脚本还会自动帮你完成三件容易遗漏的事把 SDK 运行时 DLLlibcangjie-lsp.dll、libc.dll、libunwind.dll、libwinpthread-1.dll复制到build/bin/避免运行时依赖 PATH把 config/ 下的valid_options.json、passes.json 等部署到build/bin/config/工具查找配置的候选位置使用-i时对output/bin/执行同样的部署。4️⃣ 构建产物build/bin 里有什么构建完成后build/bin/目录结构如下build/ ├── bin/ │ ├── cjah.exe # 主程序 │ ├── cjah_test.exe # 测试程序-g 时 │ ├── cjast_helper_core.dll # 核心模块 │ ├── cjast_wrapper.dll # 前端封装模块 │ ├── utils.dll # 工具模块 │ ├── cjast_desugar_pass.dll # 解糖 pass 插件 │ ├── cjast_to_source_pass.dll # 源码还原 pass 插件 │ ├── config/ # valid_options.json / passes.json │ └── SDK 运行时 DLLlibcangjie-lsp.dll 等 └── lib/ # 导入库*.dll.a这些动态库分别对应 src/core/ 核心逻辑、src/wrapper/ 前端封装与 src/passes/ 插件模块Pass 以插件动态库形式加载这也是架构设计的亮点详见 doc/design.md。5️⃣ 快速验证两条命令确认构建成功构建成功 ≠ 能跑起来。用下面两条命令做最小验证# 1) 纯语法检查快速验证 ./build/bin/cjah.exe --check-syntaxtrue test\data\inputs\main.cj # 2) 打印 parse 阶段源码到指定目录 ./build/bin/cjah.exe --dump-sourceparse test\data\inputs\main.cj --output-dir build\bin\tmp_out注意两点路径请使用 Windows 格式test\data\...或D:/...。在 git-bash/MSYS 中/d/...形式的路径会触发前端报错error: invalid file or directory诊断信息语法错误等输出到stderrcheck-syntax的退出码不能作为唯一判据无效目录时退出码为 0请以 stderr 诊断内容为准。完整的命令行选项--dump-source各阶段、--dump-ast、--filter-decls等见 doc/usage.md。6️⃣ 常见问题速查4 个坑一次说清Q1构建报Please set correct CANGJIE_INCLUDE多半是 DevEco Studio / ohpm 写入的用户级CANGJIE_HOME抢占了变量——它指向的渠道工具链不含 C include 头。推荐用-d显式指定完整 SDKbuild.bat -b -t Debug -d D:/sdks/cangjieQ2启动即段错误退出码 139没有任何 Exception 输出典型症状打印若干行find ... json配置查找日志后直接崩溃。根因是编译头文件、链接导入库、运行时 DLL 三者来自不同版本SDK跨 DLL C ABI 不兼容。确认CANGJIE_HOME与编译所用 SDK 一致后重新构建即可。Q3提示缺utils.dll但目录里明明有该提示具有误导性实际缺失的往往是libssp-0.dllllvm-mingw 的 stack protector 运行库。可用objdump -p build/bin/cjah.exe | grep DLL Name核对依赖清单从 llvm-mingw 的x86_64-w64-mingw32/bin/复制该 DLL 到build/bin/即可。Q4运行时有find ... json日志是错误吗不是。工具按 exe 目录依次查找config/加载valid_options.json/ passes.json构建脚本已把这些配置部署到build/bin/config/日志属于正常行为。写在最后总结一下 CJASTHelper 的 Windows 构建要点锁定 20220906 msvcrt 后端的 llvm-mingw 工具链在 scripts/win_env.ps1 里配好MINGW_BIN与CANGJIE_HOME两者必须同源然后一条build.bat -b -t Release即可产出完整的cjah.exe工具包。更多细节可参考 doc/build-windows.mdWindows 构建指导、doc/testing.md测试套件运行与 README.md功能总览。Happy Building 【免费下载链接】CJASTHelperCangjie Abstract Syntax Tree Helper项目地址: https://gitcode.com/Cangjie-SIG/CJASTHelper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CJASTHelper Windows构建指南基于llvm-mingw工具链快速上手【免费下载链接】CJASTHelperCangjie Abstract Syntax Tree Helper项目地址: https://gitcode.com/Cangjie-SIG/CJASTHelperCJASTHelperCangjie Abstract Syntax Tree Helper是基于 Cangjie 开源编译器前端的 AST 操作与源码转换工具提供多阶段源码打印、AST 转储、纯语法检查与 Pass 插件化分析管线。本文带你用llvm-mingw 工具链 CMake Ninja在 Windows 上完成 CJASTHelper 的快速构建从环境配置到产出可运行的cjah.exe并附常见构建问题速查清单。1️⃣ 构建前必备4 项依赖一次备齐在开始之前请确认本机已准备以下依赖。CJASTHelper 的 Windows 构建走 clang 交叉编译路线而不是 MSVC这一点决定了工具链的选择依赖要求说明llvm-mingw 工具链必须为 20220906 版本、msvcrt 后端提供x86_64-w64-mingw32-clang/clang、llvm-ar、llvm-ranlib并随包提供libssp-0.dllCangjie Windows SDK需为官方完整 SDK提供 C 头文件、导入库libcangjie-lsp.dll.a与运行时libcangjie-lsp.dllCMake3.16.5 及以上构建系统Ninja任意新版构建执行器可用 Scoop 安装⚠️关键提醒请勿混用其它版本或 ucrt 后端构建的 llvm-mingw 工具链。运行时依赖libssp-0.dll、libc.dll等与 ABI 行为均以 20220906 msvcrt 后端为准混用会触发难排查的链接或运行问题。CMake 中对编译器的引用见 CMakeLists.txt。关于工具链来源与 SDK 版本细节建议直接阅读官方文档 doc/build-windows.md其中对依赖版本有权威说明。2️⃣ 环境路径配置只需改一个文件CJASTHelper 把机器相关的路径全部集中在 scripts/win_env.ps1 中由 build.ps1 自动加载第 26 行dot-source引入构建脚本内不再出现任何硬编码路径。你只需按本机情况修改这几个变量变量示例值指向什么MINGW_BIND:/sdks/llvm-mingw-20220906-msvcrt-x86_64/binllvm-mingw 的 bin 目录CANGJIE_HOMED:/sdks/cangjieCangjie SDK 根目录SCOOP_SHIMSC:/Users/name/scoop/shimsninja 所在 shims 目录自动追加进 PATHGTEST_RELEASE_PATHD:/sdks/googletestgoogletest 预编译目录仅测试构建-g需要路径解析优先级同名环境变量 文件内默认值。也就是说不动文件也能临时切换环境非常适合 CI 或多 SDK 并存的场景$env:MINGW_BIN D:/sdks/llvm-mingw-15/bin $env:CANGJIE_HOME D:/sdks/cangjie powershell -File build.ps1 -t Debug -b⚠️最重要的一条规则CANGJIE_HOME必须与提供编译头文件的 SDK 是同一套。编译按头文件定义的类布局构造CompilerInvocation等对象运行时跨 DLL 传给libcangjie-lsp.dll。若头文件与动态库来自不同 SDK 版本类成员偏移不一致程序会在启动后直接段错误SIGSEGV退出码 139这是 Windows 上最高频的疑难杂症。3️⃣ 一键构建build.bat 三步全自动路径配置好后构建入口就是 build.bat——它是 build.ps1 的薄包装双击友好、命令行通用# Debug 构建默认 build.bat -b -t Debug # Release 构建 build.bat -b -t Release # 构建并安装到 output/ 目录 powershell -File build.ps1 -t Release -ibuild.ps1的选项与 Linux 版build.sh完全一致同一命令可直接跨平台复用常用选项如下选项说明-v打印实际执行的构建命令-g开启 googletest 测试构建-t构建类型Debug/Release默认 Debug-d覆盖 Cangjie 库路径Windows 下会同时统一CANGJIE_HOME防跨 SDK ABI 崩溃-b仅构建-i构建并安装到output/-c清理build/与output/-r构建后直接运行 cjah参数放在--之后一次成功的构建脚本还会自动帮你完成三件容易遗漏的事把 SDK 运行时 DLLlibcangjie-lsp.dll、libc.dll、libunwind.dll、libwinpthread-1.dll复制到build/bin/避免运行时依赖 PATH把 config/ 下的valid_options.json、passes.json 等部署到build/bin/config/工具查找配置的候选位置使用-i时对output/bin/执行同样的部署。4️⃣ 构建产物build/bin 里有什么构建完成后build/bin/目录结构如下build/ ├── bin/ │ ├── cjah.exe # 主程序 │ ├── cjah_test.exe # 测试程序-g 时 │ ├── cjast_helper_core.dll # 核心模块 │ ├── cjast_wrapper.dll # 前端封装模块 │ ├── utils.dll # 工具模块 │ ├── cjast_desugar_pass.dll # 解糖 pass 插件 │ ├── cjast_to_source_pass.dll # 源码还原 pass 插件 │ ├── config/ # valid_options.json / passes.json │ └── SDK 运行时 DLLlibcangjie-lsp.dll 等 └── lib/ # 导入库*.dll.a这些动态库分别对应 src/core/ 核心逻辑、src/wrapper/ 前端封装与 src/passes/ 插件模块Pass 以插件动态库形式加载这也是架构设计的亮点详见 doc/design.md。5️⃣ 快速验证两条命令确认构建成功构建成功 ≠ 能跑起来。用下面两条命令做最小验证# 1) 纯语法检查快速验证 ./build/bin/cjah.exe --check-syntaxtrue test\data\inputs\main.cj # 2) 打印 parse 阶段源码到指定目录 ./build/bin/cjah.exe --dump-sourceparse test\data\inputs\main.cj --output-dir build\bin\tmp_out注意两点路径请使用 Windows 格式test\data\...或D:/...。在 git-bash/MSYS 中/d/...形式的路径会触发前端报错error: invalid file or directory诊断信息语法错误等输出到stderrcheck-syntax的退出码不能作为唯一判据无效目录时退出码为 0请以 stderr 诊断内容为准。完整的命令行选项--dump-source各阶段、--dump-ast、--filter-decls等见 doc/usage.md。6️⃣ 常见问题速查4 个坑一次说清Q1构建报Please set correct CANGJIE_INCLUDE多半是 DevEco Studio / ohpm 写入的用户级CANGJIE_HOME抢占了变量——它指向的渠道工具链不含 C include 头。推荐用-d显式指定完整 SDKbuild.bat -b -t Debug -d D:/sdks/cangjieQ2启动即段错误退出码 139没有任何 Exception 输出典型症状打印若干行find ... json配置查找日志后直接崩溃。根因是编译头文件、链接导入库、运行时 DLL 三者来自不同版本SDK跨 DLL C ABI 不兼容。确认CANGJIE_HOME与编译所用 SDK 一致后重新构建即可。Q3提示缺utils.dll但目录里明明有该提示具有误导性实际缺失的往往是libssp-0.dllllvm-mingw 的 stack protector 运行库。可用objdump -p build/bin/cjah.exe | grep DLL Name核对依赖清单从 llvm-mingw 的x86_64-w64-mingw32/bin/复制该 DLL 到build/bin/即可。Q4运行时有find ... json日志是错误吗不是。工具按 exe 目录依次查找config/加载valid_options.json/ passes.json构建脚本已把这些配置部署到build/bin/config/日志属于正常行为。写在最后总结一下 CJASTHelper 的 Windows 构建要点锁定 20220906 msvcrt 后端的 llvm-mingw 工具链在 scripts/win_env.ps1 里配好MINGW_BIN与CANGJIE_HOME两者必须同源然后一条build.bat -b -t Release即可产出完整的cjah.exe工具包。更多细节可参考 doc/build-windows.mdWindows 构建指导、doc/testing.md测试套件运行与 README.md功能总览。Happy Building 【免费下载链接】CJASTHelperCangjie Abstract Syntax Tree Helper项目地址: https://gitcode.com/Cangjie-SIG/CJASTHelper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
