Development Tips

If you're developing on both Mac and PC:

Git Line Endings

Windows uses CRLF, Mac uses LF. Configure Git to handle this automatically:

# On Mac
git config --global core.autocrlf input

# On Windows
git config --global core.autocrlf true

Or add a .gitattributes to your repo:

* text=auto
*.sh text eol=lf
*.ps1 text eol=crlf

File Path Differences

macOS	Windows	Watch For
/Users/fabio/	C:\Users\fabio\	Forward vs backslash
Case-sensitive (APFS optional)	Case-insensitive (NTFS)	README.md ≠ readme.md on Mac
No drive letters	C:\, D:\	Absolute paths in scripts
255 char filenames	260 char path limit	Long nested paths break on Windows

Shared Drives and Permissions

Files shared via SMB may lose macOS-specific permissions. If you see files with wrong permissions after copying from a PC:

# Fix executable scripts
chmod +x script.sh

# Fix folder permissions
find /path -type d -exec chmod 755 {} \;

# Fix file permissions
find /path -type f -exec chmod 644 {} \;

Troubleshooting

Problem	Fix
Can't see the PC in Finder → Network	Make sure Network Discovery is on in Windows and both devices are on the same network
"Connection failed" when connecting to SMB share	Check the IP address, make sure the firewall allows SMB (port 445), and try smb://IP explicitly
Slow file transfers over SMB	Use ethernet instead of Wi-Fi, or check for SMB signing issues (System Settings → General → Sharing → Options → try disabling SMB signing)
Files copied from PC have wrong permissions	Use chmod to fix (see above), or mount with specific options: mount_smbfs -o noperm
Printer shared from Mac doesn't appear on PC	Ensure both are on the same subnet, and the Mac firewall allows printer sharing
Mapped network drive disappears after reboot	On Windows, re-map with "Reconnect at sign-in" checked. On Mac, add to Login Items
Special characters in filenames cause issues	Avoid \ / : * ? " < > and pipe characters in filenames: they're illegal on Windows but allowed on Mac