Files
test-repo/docs/.vitepress/theme/components/appendix/development-tools/EnvVarOverviewDemo.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

355 lines
7.5 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters
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="content-layout">
<div class="env-table">
<div class="table-header">
<span>变量名</span>
<span>示例值</span>
</div>
<div
v-for="item in envVars"
:key="item.key"
class="env-row"
:class="{ selected: selected?.key === item.key }"
@click="echoVar(item)"
>
<span class="env-key">{{ item.key }}</span>
<span class="env-value">{{ item.value }}</span>
</div>
</div>
<div class="terminal-panel">
<div class="term-titlebar">
<span class="dot red" />
<span class="dot yellow" />
<span class="dot green" />
<span class="term-name">bash</span>
</div>
<div ref="termBody" class="term-body">
<div
v-for="line in termLines"
:key="line.id"
:class="['term-line', `line-${line.type}`]"
>
{{ line.text }}
</div>
<div class="term-prompt">$ <span class="cursor"></span></div>
</div>
<div v-if="selected" class="term-desc">
<div class="desc-title">{{ selected.key }}</div>
<div class="desc-body">{{ selected.desc }}</div>
</div>
</div>
</div>
<div class="info-box">
<strong>核心概念</strong>环境变量是每个进程持有的一组=配置程序启动时自动从父进程继承一份可随时通过
<code>echo $变量名</code> 查看 <code>export KEY=value</code> 设置
</div>
</div>
</template>
<script setup>
import { ref, nextTick } from 'vue'
let lineId = 0
const termLines = ref([{ id: lineId++, type: 'hint', text: '← 点击左侧任意变量行来查看它' }])
const selected = ref(null)
const termBody = ref(null)
const envVars = [
{
key: 'HOME',
value: '/Users/alice',
desc: '当前用户的主目录路径。cd ~ 本质上就是跳到 $HOME。很多程序把配置文件存在这里。'
},
{
key: 'USER',
value: 'alice',
desc: '当前登录的用户名。服务器程序常用它做权限判断或日志记录。'
},
{
key: 'SHELL',
value: '/bin/zsh',
desc: '当前使用的 Shell 程序路径。决定了你输入命令后由哪个程序来解释执行。'
},
{
key: 'PATH',
value: '/usr/local/bin:/usr/bin:/bin',
desc: '最重要的环境变量!Shell 查找可执行文件时,依次在这些目录里搜索,用冒号分隔。见下方演示。'
},
{
key: 'PWD',
value: '/Users/alice/projects',
desc: '当前工作目录(Print Working Directory)。就是你现在"站在"的那个目录。'
},
{
key: 'LANG',
value: 'zh_CN.UTF-8',
desc: '系统语言和字符编码。影响程序的错误提示语言、日期格式、排序规则等。'
},
{
key: 'NODE_ENV',
value: 'development',
desc: '开发者自定义变量。告诉 Node.js 应用当前是开发(development)还是生产(production)环境,影响日志、错误显示等行为。'
},
{
key: 'OPENAI_API_KEY',
value: 'sk-••••••••••••••••',
desc: '开发者自定义变量,存储 API 密钥。把密钥放在环境变量里(而非写死在代码里)是重要的安全最佳实践。'
}
]
const echoVar = (item) => {
selected.value = item
termLines.value.push(
{ id: lineId++, type: 'cmd', text: `$ echo $${item.key}` },
{ id: lineId++, type: 'output', text: item.value }
)
nextTick(() => {
if (termBody.value) {
termBody.value.scrollTop = termBody.value.scrollHeight
}
})
}
</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.75rem;
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);
}
.content-layout {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 1rem;
margin-bottom: 0.75rem;
}
@media (max-width: 720px) {
.content-layout {
grid-template-columns: 1fr;
}
}
.env-table {
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
overflow: hidden;
background: var(--vp-c-bg);
}
.table-header {
display: grid;
grid-template-columns: 1fr 1.4fr;
padding: 0.4rem 0.75rem;
background: var(--vp-c-bg-alt);
font-size: 0.75rem;
color: var(--vp-c-text-2);
border-bottom: 1px solid var(--vp-c-divider);
font-weight: 600;
}
.env-row {
display: grid;
grid-template-columns: 1fr 1.4fr;
padding: 0.5rem 0.75rem;
cursor: pointer;
border-bottom: 1px solid var(--vp-c-divider);
font-family: var(--vp-font-family-mono);
font-size: 0.8rem;
transition: background 0.15s;
align-items: center;
}
.env-row:last-child {
border-bottom: none;
}
.env-row:hover {
background: var(--vp-c-bg-soft);
}
.env-row.selected {
background: color-mix(in srgb, var(--vp-c-brand) 12%, transparent);
border-left: 3px solid var(--vp-c-brand);
}
.env-key {
color: var(--vp-c-brand);
font-weight: bold;
font-size: 0.78rem;
}
.env-value {
color: var(--vp-c-text-2);
font-size: 0.76rem;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.terminal-panel {
display: flex;
flex-direction: column;
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
overflow: hidden;
background: #1e1e2e;
}
.term-titlebar {
display: flex;
align-items: center;
gap: 0.4rem;
padding: 0.45rem 0.75rem;
background: #181825;
}
.dot {
width: 11px;
height: 11px;
border-radius: 50%;
display: inline-block;
}
.dot.red {
background: #ff5f57;
}
.dot.yellow {
background: #febc2e;
}
.dot.green {
background: #28c840;
}
.term-name {
margin-left: 0.4rem;
font-size: 0.75rem;
color: #6c7086;
}
.term-body {
padding: 0.6rem 0.75rem;
min-height: 150px;
max-height: 200px;
overflow-y: auto;
overflow-x: hidden;
font-family: var(--vp-font-family-mono);
font-size: 0.8rem;
line-height: 1.7;
word-break: break-all;
}
.term-line {
margin: 0;
}
.line-hint {
color: #585b70;
font-style: italic;
}
.line-cmd {
color: #a6e3a1;
}
.line-output {
color: #cdd6f4;
}
.term-prompt {
color: #585b70;
margin-top: 0.25rem;
}
.cursor {
animation: blink 1s step-end infinite;
color: #cdd6f4;
}
@keyframes blink {
0%,
100% {
opacity: 1;
}
50% {
opacity: 0;
}
}
.term-desc {
border-top: 1px solid #313244;
padding: 0.6rem 0.75rem;
background: #11111b;
}
.desc-title {
font-size: 0.78rem;
color: var(--vp-c-brand);
font-weight: bold;
margin-bottom: 0.25rem;
font-family: var(--vp-font-family-mono);
}
.desc-body {
font-size: 0.75rem;
color: #7f849c;
line-height: 1.5;
}
.info-box {
display: block;
background: var(--vp-c-bg-alt);
border-radius: 6px;
padding: 0.6rem 0.75rem;
font-size: 0.85rem;
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>