Files
test-repo/docs/.vitepress/theme/components/appendix/development-tools/EnvScopeDemo.vue
T
sanbuphy 6098908eee feat(docs): add interactive demos and complete content for development tools
- Add Vue components for interactive demos (SSH auth, regex, env vars, ports)
- Complete markdown content for SSH, regex, environment variables, and ports
- Remove placeholder "待实现" sections and replace with detailed guides
- Add visual explanations for key concepts like ports and localhost
- Include practical examples and troubleshooting tips
- Add component for showing evolution from transistors to CPU
- Improve documentation structure and navigation
- Add security best practices for API keys and environment variables
2026-02-21 10:04:47 +08:00

332 lines
8.6 KiB
Vue
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<template>
<div class="demo-root">
<div class="demo-header">
<span class="title">环境变量的三个层级</span>
<span class="subtitle">变量从外到内单向传递子进程继承父进程的副本</span>
</div>
<div class="scope-stack">
<div class="scope-layer system">
<div class="layer-header">
<span class="layer-icon">🖥</span>
<div>
<div class="layer-title">系统级 <code>/etc/environment</code></div>
<div class="layer-desc">所有用户所有进程都能看到由管理员配置</div>
</div>
</div>
<div class="var-list">
<div v-for="v in systemVars" :key="v.key" class="var-chip system-chip">
<span class="chip-key">{{ v.key }}</span><span class="chip-eq">=</span><span class="chip-val">{{ v.value }}</span>
</div>
</div>
</div>
<div class="arrow-row">
<span class="arrow-line" />
<span class="arrow-label"> 子进程继承父进程环境</span>
<span class="arrow-line" />
</div>
<div class="scope-layer user">
<div class="layer-header">
<span class="layer-icon">👤</span>
<div>
<div class="layer-title">用户级 <code>~/.zshrc</code></div>
<div class="layer-desc">只影响当前用户登录 Shell 启动时自动加载</div>
</div>
</div>
<div class="var-list">
<div v-for="v in userVars" :key="v.key" class="var-chip user-chip">
<span class="chip-key">{{ v.key }}</span><span class="chip-eq">=</span><span class="chip-val">{{ v.value }}</span>
</div>
<div class="add-row">
<input v-model="newKey" class="var-input" placeholder="KEY" maxlength="18" @keyup.enter="addVar" />
<span class="eq-sign">=</span>
<input v-model="newVal" class="var-input" placeholder="value" maxlength="24" @keyup.enter="addVar" />
<button class="add-btn" :disabled="!newKey || !newVal" @click="addVar">export</button>
</div>
</div>
</div>
<div class="arrow-row">
<span class="arrow-line" />
<span class="arrow-label"> 启动子进程 node app.js</span>
<span class="arrow-line" />
</div>
<div class="scope-layer process">
<div class="layer-header">
<span class="layer-icon"></span>
<div>
<div class="layer-title">进程级当前运行的程序</div>
<div class="layer-desc">继承所有上层变量退出后消失修改不影响父进程</div>
</div>
</div>
<div class="var-list">
<div v-for="v in processVars" :key="v.key" class="var-chip process-chip" :class="{ 'is-new': v.isNew }">
<span class="chip-key">{{ v.key }}</span><span class="chip-eq">=</span><span class="chip-val">{{ v.value }}</span>
<span v-if="v.isNew" class="new-badge">你加的</span>
</div>
</div>
</div>
</div>
<div class="info-box">
<strong>单向传递</strong>变量只能向下继承子进程修改变量值不会影响父进程关闭终端后直接 <code>export</code> 的变量也会消失
</div>
</div>
</template>
<script setup>
import { ref, computed } from 'vue'
const systemVars = [
{ key: 'PATH', value: '/usr/local/bin:/usr/bin:/bin' },
{ key: 'LANG', value: 'zh_CN.UTF-8' },
{ key: 'TZ', value: 'Asia/Shanghai' }
]
const baseUserVars = [
{ key: 'HOME', value: '/Users/alice' },
{ key: 'SHELL', value: '/bin/zsh' },
{ key: 'NVM_DIR', value: '$HOME/.nvm' }
]
const extraVars = ref([])
const newKey = ref('')
const newVal = ref('')
const userVars = computed(() => [...baseUserVars, ...extraVars.value])
const processVars = computed(() => [
...systemVars,
...userVars.value.map((v) => ({ ...v })),
{ key: 'NODE_ENV', value: 'development' },
{ key: 'PORT', value: '3000' }
])
const addVar = () => {
if (!newKey.value || !newVal.value) return
const key = newKey.value.toUpperCase().replace(/[^A-Z0-9_]/g, '_')
if (extraVars.value.some((v) => v.key === key)) return
extraVars.value.push({ key, value: newVal.value, isNew: true })
newKey.value = ''
newVal.value = ''
}
</script>
<style scoped>
.demo-root {
border: 1px solid var(--vp-c-divider);
border-radius: 8px;
background: var(--vp-c-bg-soft);
padding: 1rem;
margin: 0.75rem 0;
min-width: 0;
overflow: hidden;
}
.demo-header {
display: flex;
align-items: baseline;
gap: 0.6rem;
flex-wrap: wrap;
margin-bottom: 1rem;
}
.demo-header .title {
font-size: 1rem;
font-weight: bold;
color: var(--vp-c-text-1);
}
.demo-header .subtitle {
font-size: 0.82rem;
color: var(--vp-c-text-2);
}
.scope-stack {
display: flex;
flex-direction: column;
gap: 0;
margin-bottom: 0.75rem;
min-width: 0;
}
.scope-layer {
border: 2px solid var(--vp-c-divider);
border-radius: 8px;
padding: 0.7rem 0.85rem;
background: var(--vp-c-bg);
}
.scope-layer.system {
border-color: var(--vp-c-yellow-1, #f59e0b);
background: color-mix(in srgb, var(--vp-c-yellow-1, #f59e0b) 5%, var(--vp-c-bg));
}
.scope-layer.user {
border-color: var(--vp-c-brand);
background: color-mix(in srgb, var(--vp-c-brand) 5%, var(--vp-c-bg));
}
.scope-layer.process {
border-color: var(--vp-c-green-1);
background: color-mix(in srgb, var(--vp-c-green-1) 5%, var(--vp-c-bg));
}
.layer-header {
display: flex;
align-items: flex-start;
gap: 0.55rem;
margin-bottom: 0.55rem;
}
.layer-icon {
font-size: 1.1rem;
flex-shrink: 0;
margin-top: 1px;
}
.layer-title {
font-size: 0.85rem;
font-weight: bold;
color: var(--vp-c-text-1);
margin-bottom: 0.1rem;
}
.layer-title code {
font-size: 0.78rem;
background: var(--vp-c-bg-soft);
padding: 0 0.3rem;
border-radius: 3px;
color: var(--vp-c-brand);
}
.layer-desc {
font-size: 0.76rem;
color: var(--vp-c-text-2);
line-height: 1.4;
}
.var-list {
display: flex;
flex-wrap: wrap;
gap: 0.4rem;
align-items: center;
min-width: 0;
}
.var-chip {
display: inline-flex;
align-items: center;
padding: 0.18rem 0.45rem;
border-radius: 4px;
font-family: var(--vp-font-family-mono);
font-size: 0.75rem;
border: 1px solid;
max-width: 100%;
min-width: 0;
}
.system-chip { border-color: var(--vp-c-yellow-1, #f59e0b); background: color-mix(in srgb, var(--vp-c-yellow-1, #f59e0b) 12%, var(--vp-c-bg)); }
.user-chip { border-color: var(--vp-c-brand); background: color-mix(in srgb, var(--vp-c-brand) 10%, var(--vp-c-bg)); }
.process-chip { border-color: var(--vp-c-green-1); background: color-mix(in srgb, var(--vp-c-green-1) 10%, var(--vp-c-bg)); }
.process-chip.is-new { border-style: dashed; }
.chip-key { font-weight: bold; color: var(--vp-c-brand); }
.chip-eq { color: var(--vp-c-text-3); margin: 0 1px; }
.chip-val { color: var(--vp-c-text-2); max-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.new-badge {
margin-left: 0.35rem;
background: var(--vp-c-green-1);
color: white;
font-size: 0.62rem;
padding: 0 0.28rem;
border-radius: 3px;
font-family: var(--vp-font-family-base);
white-space: nowrap;
}
.add-row {
display: flex;
align-items: center;
gap: 0.3rem;
width: 100%;
margin-top: 0.1rem;
}
.var-input {
flex: 1;
min-width: 0;
padding: 0.22rem 0.4rem;
border: 1px solid var(--vp-c-divider);
border-radius: 4px;
background: var(--vp-c-bg);
color: var(--vp-c-text-1);
font-family: var(--vp-font-family-mono);
font-size: 0.76rem;
outline: none;
}
.var-input:focus { border-color: var(--vp-c-brand); }
.eq-sign { color: var(--vp-c-text-3); font-family: var(--vp-font-family-mono); }
.add-btn {
padding: 0.22rem 0.6rem;
background: var(--vp-c-brand);
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 0.76rem;
font-family: var(--vp-font-family-mono);
white-space: nowrap;
flex-shrink: 0;
}
.add-btn:disabled { opacity: 0.4; cursor: not-allowed; }
.arrow-row {
display: flex;
align-items: center;
gap: 0.5rem;
padding: 0.3rem 0;
}
.arrow-line {
flex: 1;
height: 1px;
background: var(--vp-c-divider);
}
.arrow-label {
font-size: 0.72rem;
color: var(--vp-c-text-3);
white-space: nowrap;
}
.info-box {
display: block;
background: var(--vp-c-bg-alt);
border-radius: 6px;
padding: 0.6rem 0.75rem;
font-size: 0.84rem;
color: var(--vp-c-text-2);
line-height: 1.6;
}
.info-box strong { white-space: nowrap; color: var(--vp-c-text-1); }
.info-box code {
font-family: var(--vp-font-family-mono);
font-size: 0.8rem;
background: var(--vp-c-bg);
padding: 0 0.3rem;
border-radius: 3px;
color: var(--vp-c-brand);
}
</style>