菜单
Use when invoking Xmake from the command line — configuring, building, running, cleaning, installing, packing, or inspecting a project. Covers the common flags for `xmake f`, `xmake`, `xmake run`, `xmake install`, `xmake pack`, and friends.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | xmake-commands |
| description | Use when invoking Xmake from the command line — configuring, building, running, cleaning, installing, packing, or inspecting a project. Covers the common flags for `xmake f`, `xmake`, `xmake run`, `xmake install`, `xmake pack`, and friends. |
Xmake's CLI is a single xmake binary with subcommands. Without a subcommand it runs build.
xmake f / xmake config)xmake f -m release # build mode
xmake f -p linux -a x86_64 # platform + arch
xmake f --toolchain=clang
xmake f -c # clear old config
xmake f --menu # interactive TUI (shows all options)
xmake f -v # verbose
Config is persisted under .xmake/, so later xmake calls reuse it.
xmake # build all default targets
xmake app # build a specific target
xmake -r # rebuild (force)
xmake -j 8 # parallel jobs
xmake -v # show compile commands
xmake -vD # verbose + diagnostics (for debugging xmake.lua)
xmake -w # treat warnings
xmake run # run default runnable target
xmake run app arg1 arg2 # pass arguments
xmake run -d app # run under debugger (gdb/lldb/cdb)
xmake clean # current config
xmake clean --all # all configs
xmake clean app # one target
xmake install -o /usr/local
xmake install --root app # one target, root-prefixed
xmake uninstall -o /usr/local
xmake pack)Produce distributable archives (zip/tar.gz/deb/rpm/nsis/wix/...):
xmake pack # default format
xmake pack -f zip
xmake pack -f nsis # Windows installer
xmake pack -f deb mylib # Debian package for one target
Packaging metadata is defined via xpack(...) in xmake.lua.
xmake show # project summary
xmake show -l targets
xmake show -l toolchains
xmake show -l plats
xmake show -t app # info for one target
xmake show --key=options
xmake project -k compile_commands # compile_commands.json
xmake project -k cmakelists # CMakeLists.txt (one-way export)
xmake project -k vsxmake -m "debug,release" # Visual Studio solution
xmake project -k xcode # Xcode project
xmake update # stable
xmake update -s dev # dev branch
xmake test → xmake-testsxpack interfaces → see xmake docsUse when switching xmake's output theme (colors, progress style, emoji) or fixing garbled/unreadable terminal output — `xmake g --theme=...`. Built-in themes: default, ninja, emoji, dark, light, plain, powershell.
Use when the user is starting a new Xmake project, installing Xmake, or needs the minimal xmake.lua structure. Covers installation, `xmake create`, the project layout, and the smallest valid xmake.lua.
Use when writing or reviewing an `xmake.lua` (project, package recipe, or toolchain) and you want to follow idiomatic xmake style — description vs script domain separation, naming, indentation, `set_` vs `add_`, option/config organization, and common conventions used across xmake-repo and the xmake project itself. Apply this alongside `xmake-targets`/`xmake-packages`/etc. as a stylistic overlay.
Use when creating a new xmake project from a built-in or third-party template (`xmake create -t <template>`), listing available templates, or authoring and distributing custom templates (built-in, user-global, or via xmake-repo). Covers template layout, `${TARGET_NAME}` / `${FAQ}` substitution, and language selection.
Use when exporting an xmake project to another build system or IDE — `compile_commands.json` for clangd/LSP, `CMakeLists.txt`, `build.ninja`, Visual Studio solution (`vsxmake`), or an Xcode project. Covers `xmake project -k <kind>` and how each generator is typically used.
Use when you want to build a third-party project that uses CMake, Autotools, Meson, Ninja, Bazel, Make, MSBuild, Xcodebuild, or NdkBuild — through xmake, so you inherit xmake's cross-compilation and toolchain detection. Covers `xmake` auto-detection, `--trybuild=<system>`, `--tryconfigs="..."`, and cross-compile recipes for Android / iOS / MinGW / custom SDKs.