xero/miasma.nvim 开源项目中文解读：技术栈、适用场景与上手建议

584

Creative Commons Zero v1.0 Universal

项目介绍

xero/miasma.nvim 是一个托管在 GitHub 上的开源项目，主要使用 Vim Script 编写，采用 Creative Commons Zero v1.0 Universal 许可证，目前获得 584 个 Star、33 次 Fork。

仓库全名: xero/miasma.nvim
开源许可证: Creative Commons Zero v1.0 Universal
Star 数: 584
Fork 数: 33
未关闭 Issue: 4

README 摘要

miasma.nvim ☁️ a color scheme for {neo,}vim inspired by the woods, built using lush 👄 supports treesitter, gitsigns, lazy, which-key, telescope, lsp diagnostics, and more. a fog descends upon your editor https://github.com/xero/miasma.nvim flavors this theme is available in a classic vim compatible format, optimized lua, and a development lua version. you can install different flavors by using the corresponding…

完整内容见 GitHub 原始 README 或本页。

常见问题

miasma.nvim 用什么语言开发？

主要使用 Vim Script 编写，采用 Creative Commons Zero v1.0 Universal 许可证，目前有 584 个 Star。

miasma.nvim 可以免费商用吗？

仓库标注的许可证为 Creative Commons Zero v1.0 Universal，商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 miasma.nvim 的源码？

可以直接克隆仓库：git clone https://github.com/xero/miasma.nvim.git，默认分支为 main；安装与运行步骤见仓库 README。

miasma.nvim 最近还在维护吗？

仓库最近一次更新为 2025年7月12日，当前有 4 个未关闭 Issue；Star 数为 584，可作为社区活跃度的参考。

关于

a fog descends upon your editor ☁ dark color scheme inspired by the woods for vim and neovim

描述取自 GitHub 官方 API，中文内容由 GitRead 中文社区编辑团队整理。

简要分析

热度分

652

价值分

360

活跃状态

活跃

color-scheme colorscheme fog forest miasma neovim neovim-colors neovim-colorscheme neovim-plugin neovim-theme nvim treesitter-colorscheme vim vim-colors vim-colorscheme vim-plugin vim-theme woods

GitHub

语言占比

Shell

Vim Script

贡献者

README

miasma.nvim ☁️

a color scheme for {neo,}vim inspired by the woods, built using lush 👄

supports treesitter, gitsigns, lazy, which-key, telescope, lsp diagnostics, and more.

theme preview

┏┏┓o┳━┓┓━┓┏┏┓┳━┓
┃┃┃┃┃━┫┗━┓┃┃┃┃━┫
┛ ┇┇┛ ┇━━┛┛ ┇┛ ┇

a fog descends upon your editor https://github.com/xero/miasma.nvim

flavors

this theme is available in a classic vim compatible format, optimized lua, and a development lua version. you can install different flavors by using the corresponding branches:

main - classic vim version
lua - optimized lua version (coming soon)
dev - development lua version

for speed and greatest compatibility, use the main branch.

installation

using lazy

{
  "xero/miasma.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd("colorscheme miasma")
  end,
}

using plug

Plug 'xero/miasma.nvim'
colorscheme miasma

using packer

use {"xero/miasma.nvim"}
vim.cmd("colorscheme miasma")

usage

set the color scheme with the builtin command :colorscheme

customization

this theme is built with lush.nvim, so customizations are quite easy.

first, checkout the dev branch git fetch origin dev && git checkout dev, open the lua theme nvim lua/lush_theme/miasma.lua and execute :Lushify. then adjust colors to suit your taste with real-time feedback. checkout the dev branch readme for details on building the optimized colorscheme. lots more details on using lush in their repo.

extras

this theme has been ported to a few different apps, and are included in the extras directory:

miasma.Xresources - colors for xclients (e.g. unix terminal emulators)
miasma.itermcolors - colors for iterm2
miasma.fish - colors for fish
miasma.zsh - colors for zsh
miasma.yml - colors for alacritty (yml format)
miasma.toml - colors for alacritty (toml format)
miasma.colorscheme - colors for qterminal
miasma.ghostty - colors for ghostty

more on the way, and pr’s for others are welcomed!

license

kopimi logo

all files and scripts in this repo are released CC0 / kopimi! in the spirit of freedom of information, i encourage you to fork, modify, change, share, or do whatever you like with this project! ^c^v

miasma.nvim