菜单
Use 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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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 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.
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.
| name | xmake-theme |
| description | Use 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. |
Xmake's terminal output can be re-themed globally. Themes control color palette, the progress bar style, and whether emoji are used. Configured per-machine via xmake g.
xmake g --theme=default # default: colorful, rolling progress
xmake g --theme=ninja # ninja-style single-line progress bar
xmake g --theme=emoji # uses emoji in place of colors
xmake g --theme=dark # darker palette for very light terminals
xmake g --theme=light # light palette for very dark terminals
xmake g --theme=plain # strip all color/emoji — fixes garbled terminals
xmake g --theme=powershell # tuned for Windows PowerShell's odd palette
Reset to default:
xmake g -c # reset all global config
xmake g --theme=default
| Situation | Theme |
|---|---|
| Default dark terminal, you just want it to work | default |
| Terminal shows garbled ANSI escapes (old Windows cmd, dumb terminals) | plain |
| Warnings invisible because bg is yellow | dark |
| Text overlap on dark backgrounds | light |
| Magenta looks wrong (PowerShell) | powershell |
| Want persistent single-line progress like ninja | ninja |
| Fun / emoji UI | emoji |
If you just want to toggle color output, the XMAKE_COLORTERM env var is simpler:
export XMAKE_COLORTERM=nocolor # disable all color
export XMAKE_COLORTERM=color8 # 8 colors
export XMAKE_COLORTERM=color256 # 256 colors
export XMAKE_COLORTERM=truecolor # 24-bit true color
Or globally:
xmake g --theme=plain # full disable — same effect as nocolor
XMAKE_COLORTERM=nocolor in the CI env rather than switching themes.xmake g --theme=powershell fixes it.--theme=plain also hides emoji. Intentional — use it when terminals choke on both ANSI and unicode.plain, or switch to Windows Terminal / PowerShell 7.xmake-color-outputxmake-troubleshooting